XmlSiteMapProvider Klas

Definitie

Naamruimte:
System.Web
Assembly:
System.Web.dll

De klasse XmlSiteMapProvider is afgeleid van de klasse SiteMapProvider en is de standaardsiteoverzichtprovider voor ASP.NET. De XmlSiteMapProvider klasse genereert siteoverzichtstructuren van XML-bestanden met de bestandsextensie .sitemap.

public ref class XmlSiteMapProvider : System::Web::StaticSiteMapProvider, IDisposable
public class XmlSiteMapProvider : System.Web.StaticSiteMapProvider, IDisposable
type XmlSiteMapProvider = class
    inherit StaticSiteMapProvider
    interface IDisposable
Public Class XmlSiteMapProvider
Inherits StaticSiteMapProvider
Implements IDisposable
Overname
Object
ProviderBase
SiteMapProvider
StaticSiteMapProvider
XmlSiteMapProvider
Implementeringen
IDisposable

Opmerkingen

De XmlSiteMapProvider klasse laadt siteoverzichtgegevens uit een XML-bestand dat volgt op een bekend schema. De siteoverzichtgegevens worden gebonden door <siteMap> tags en bestaan uit geneste <siteMapNode> tags. Er worden twee beperkingen opgelegd door de SiteMapProvider en XmlSiteMapProvider klassen voor de structuur van de siteoverzichtsgegevens:

  • Er kan slechts één hoofdknooppunt bestaan.

  • Voor SiteMapNode objecten die URL's opgeven, moeten de URL's uniek zijn binnen het bereik van de provider. (Voor knooppunten die geen URL's opgeven, moeten alle sleutels uniek zijn.)

In het volgende codevoorbeeld ziet u een voorbeeld van een XML-bestand dat kan worden gebruikt met de XmlSiteMapProvider.

<siteMap>
  <siteMapNode title="RootNode" description="This is the root node of the site map. There can be only one root node." url="Page1.aspx" >
    <siteMapNode title="ChildofRootNode" description="Descriptions do not have to be unique." url="Page2.aspx">
      <siteMapNode title="ChildOfChildNode" description="SiteMapNode objects can be nested to any level." url="Page3.aspx"/>
    </siteMapNode>
    <siteMapNode title="ChildofRootNode" description="Descriptions do not have to be unique." url="Page4.aspx"/>
  </siteMapNode>
</siteMap>

De XmlSiteMapProvider is de standaardprovider voor ASP.NET en leest XML-gegevens uit een bestand met de naam Web.sitemap dat zich in de mapstructuur van de ASP.NET-toepassing bevindt. Het web.sitemapbestand bevindt zich standaard in de hoofdmap van de toepassing; Als u echter de naam of locatie van het bestand wilt wijzigen waaruit de XmlSiteMapProvider gegevens worden geladen, kunt u de standaardconfiguratie in uw Web.config-bestand overschrijven. Door de standaardconfiguratie-instellingen in uw Web.config-bestand te overschrijven, kunt u zo nodig het gedrag van de XmlSiteMapProvider aanpassen voor elke ASP.NET toepassing.

In het volgende codevoorbeeld ziet u een voorbeeld Web.config bestand, waarbij het XmlSiteMapProvider nog steeds wordt gebruikt, maar een ander siteoverzichtsbestand wordt gebruikt. Omdat alle providers in een SiteMapProviderCollection-object een unieke naam moeten hebben, gebruikt de provider die is opgegeven in het Web.config-bestand een andere naam dan de standaardprovider, maar wordt ook ingesteld als de standaardprovider, zodat deze wordt gebruikt in plaats van de XmlSiteMapProvider die is opgegeven in de standaardconfiguratie ASP.NET.

Note

U kunt de naam van het sitenavigatiegegevensbestand wijzigen, maar u kunt de extensie niet wijzigen. De XmlSiteMapProvider enige gegevens worden gelezen uit bestanden met de bestandsnaamextensie .sitemap.

<siteMap defaultProvider="MyXmlSiteMapProvider" enabled="true">
  <providers>
    <add name="MyXmlSiteMapProvider"
      description="SiteMap provider that reads in .sitemap files."
      type="System.Web.XmlSiteMapProvider, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"
      siteMapFile="CustomWeb.sitemap" />
  </providers>
</siteMap>

Constructors

Name Description
XmlSiteMapProvider()

Hiermee maakt u een nieuw, niet-benoemd exemplaar van de XmlSiteMapProvider klasse.

Eigenschappen

Name Description
CurrentNode

Hiermee haalt u het SiteMapNode object op dat de momenteel aangevraagde pagina vertegenwoordigt.
CurrentNode

Hiermee haalt u het SiteMapNode object op dat de momenteel aangevraagde pagina vertegenwoordigt.

(Overgenomen van SiteMapProvider)
Description

Hiermee krijgt u een korte, beschrijvende beschrijving die geschikt is voor weergave in beheerhulpprogramma's of andere gebruikersinterfaces (UIS's).

(Overgenomen van ProviderBase)
EnableLocalization

Hiermee wordt een Booleaanse waarde opgehaald of ingesteld die aangeeft of gelokaliseerde waarden van SiteMapNode kenmerken worden geretourneerd.

(Overgenomen van SiteMapProvider)
Name

Hiermee haalt u de beschrijvende naam op die wordt gebruikt om tijdens de configuratie naar de provider te verwijzen.

(Overgenomen van ProviderBase)
ParentProvider

Hiermee wordt het bovenliggende SiteMapProvider object van de huidige provider opgehaald of ingesteld.

(Overgenomen van SiteMapProvider)
ResourceKey

Haal de resourcesleutel op die wordt gebruikt voor het lokaliseren van SiteMapNode kenmerken of stelt deze in.

(Overgenomen van SiteMapProvider)
RootNode

Hiermee haalt u het hoofdknooppunt van het siteoverzicht op.
RootProvider

Hiermee haalt u het hoofdobject SiteMapProvider op in de huidige providerhiërarchie.

(Overgenomen van SiteMapProvider)
SecurityTrimmingEnabled

Hiermee wordt een Booleaanse waarde opgehaald die aangeeft of een siteoverzichtprovider siteoverzichtknooppunten filtert op basis van de rol van een gebruiker.

(Overgenomen van SiteMapProvider)

Methoden

Name Description
AddNode(SiteMapNode, SiteMapNode)

Hiermee voegt u een SiteMapNode object toe aan de verzamelingen die worden onderhouden door de huidige provider.
AddNode(SiteMapNode)

Hiermee voegt u een SiteMapNode object toe aan de knooppuntverzameling die wordt onderhouden door de siteoverzichtprovider.

(Overgenomen van SiteMapProvider)
AddProvider(String, SiteMapNode)

Hiermee koppelt u een onderliggende siteoverzichtprovider aan de huidige provider.
BuildSiteMap()

Laadt de siteoverzichtsgegevens uit een XML-bestand en bouwt deze in het geheugen.
Clear()

Hiermee verwijdert u alle elementen in de verzamelingen onderliggende en bovenliggende siteoverzichtknooppunten en siteoverzichtproviders die het object intern bijhoudt als onderdeel van de XmlSiteMapProvider status.
Dispose()

Hiermee wordt de bestandsmonitor op de hoogte gebracht van het Web.sitemap-bestand dat het XmlSiteMapProvider object niet langer vereist dat het bestand wordt bewaakt.
Dispose(Boolean)

Hiermee wordt de bestandsmonitor op de hoogte gebracht van het Web.sitemap-bestand dat het XmlSiteMapProvider object niet langer vereist dat het bestand wordt bewaakt. De Dispose(Boolean) methode gebruikt een Booleaanse parameter die aangeeft of de methode wordt aangeroepen door gebruikerscode.
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
FindSiteMapNode(HttpContext)

Hiermee wordt een SiteMapNode object opgehaald dat de momenteel aangevraagde pagina vertegenwoordigt met behulp van het opgegeven HttpContext object.

(Overgenomen van SiteMapProvider)
FindSiteMapNode(String)

Hiermee wordt een SiteMapNode object opgehaald dat de pagina op de opgegeven URL vertegenwoordigt.
FindSiteMapNodeFromKey(String)

Hiermee wordt een SiteMapNode object opgehaald op basis van een opgegeven sleutel.
GetChildNodes(SiteMapNode)

Retourneert de onderliggende knooppunten van het siteoverzicht.
GetChildNodes(SiteMapNode)

Hiermee worden de onderliggende siteoverzichtknooppunten van een specifiek SiteMapNode object opgehaald.

(Overgenomen van StaticSiteMapProvider)
GetCurrentNodeAndHintAncestorNodes(Int32)

Biedt een geoptimaliseerde opzoekmethode voor siteoverzichtproviders bij het ophalen van het knooppunt voor de momenteel aangevraagde pagina en het ophalen van de bovenliggende en bovenliggende siteoverzichtknooppunten voor de huidige pagina.

(Overgenomen van SiteMapProvider)
GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32)

Biedt een geoptimaliseerde opzoekmethode voor siteoverzichtproviders bij het ophalen van het knooppunt voor de momenteel aangevraagde pagina en het ophalen van de siteoverzichtknooppunten in de nabijheid van het huidige knooppunt.

(Overgenomen van SiteMapProvider)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetParentNode(SiteMapNode)

Retourneert het bovenliggende knooppunt van het siteoverzicht.
GetParentNode(SiteMapNode)

Hiermee haalt u het bovenliggende siteoverzichtknooppunt van een specifiek SiteMapNode object op.

(Overgenomen van StaticSiteMapProvider)
GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(Int32, Int32)

Biedt een geoptimaliseerde opzoekmethode voor siteoverzichtproviders bij het ophalen van een bovenliggend knooppunt voor de momenteel aangevraagde pagina en het ophalen van de onderliggende knooppunten voor de bovenliggende knooppunten.

(Overgenomen van SiteMapProvider)
GetParentNodeRelativeToNodeAndHintDownFromParent(SiteMapNode, Int32, Int32)

Biedt een geoptimaliseerde opzoekmethode voor siteoverzichtproviders bij het ophalen van een bovenliggend knooppunt voor het opgegeven SiteMapNode object en het ophalen van de onderliggende knooppunten.

(Overgenomen van SiteMapProvider)
GetRootNodeCore()

Hiermee wordt het knooppunt op het hoogste niveau van de huidige structuur van de siteoverzicht opgehaald.
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
HintAncestorNodes(SiteMapNode, Int32)

Biedt een methode die siteoverzichtproviders kunnen overschrijven om een geoptimaliseerde ophaalbewerking uit te voeren van een of meer niveaus van bovenliggende en bovenliggende knooppunten ten opzichte van het opgegeven SiteMapNode object.

(Overgenomen van SiteMapProvider)
HintNeighborhoodNodes(SiteMapNode, Int32, Int32)

Biedt een methode die siteoverzichtproviders kunnen overschrijven om een geoptimaliseerde ophaalbewerking van knooppunten uit te voeren die zich in de nabijheid van het opgegeven knooppunt bevinden.

(Overgenomen van SiteMapProvider)
Initialize(String, NameValueCollection)

Initialiseert het XmlSiteMapProvider-object. Met de Initialize(String, NameValueCollection) methode wordt geen siteoverzicht gemaakt, maar wordt alleen de status van de XmlSiteMapProvider methode voorbereid.
IsAccessibleToUser(HttpContext, SiteMapNode)

Hiermee wordt een Booleaanse waarde opgehaald die aangeeft of het opgegeven SiteMapNode object kan worden weergegeven door de gebruiker in de opgegeven context.

(Overgenomen van SiteMapProvider)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
RemoveNode(SiteMapNode)

Hiermee verwijdert u het opgegeven SiteMapNode object uit alle knooppuntverzamelingen die door de provider worden bijgehouden.
RemoveProvider(String)

Hiermee verwijdert u een gekoppelde onderliggende siteoverzichtprovider uit de hiërarchie voor de huidige provider.
ResolveSiteMapNode(HttpContext)

Hiermee wordt de SiteMapResolve gebeurtenis gegenereerd.

(Overgenomen van SiteMapProvider)
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

gebeurtenis

Name Description
SiteMapResolve

Treedt op wanneer de CurrentNode eigenschap wordt aangeroepen.

(Overgenomen van SiteMapProvider)

Van toepassing op

Zie ook