XmlSiteMapProvider.Initialize(String, NameValueCollection) Methode

Definitie

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

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

public:
 override void Initialize(System::String ^ name, System::Collections::Specialized::NameValueCollection ^ attributes);
public override void Initialize(string name, System.Collections.Specialized.NameValueCollection attributes);
override this.Initialize : string * System.Collections.Specialized.NameValueCollection -> unit
Public Overrides Sub Initialize (name As String, attributes As NameValueCollection)

Parameters

name
String

De XmlSiteMapProvider te initialiseren.

attributes
NameValueCollection

Een NameValueCollection die aanvullende kenmerken kan bevatten om te helpen initialiseren name. Deze kenmerken worden gelezen uit de XmlSiteMapProvider configuratie in het Web.config-bestand.

Uitzonderingen

InvalidOperationException

De XmlSiteMapProvider is meer dan één keer geïnitialiseerd.

HttpException

Een SiteMapNode fysiek pad gebruikt om te verwijzen naar een siteoverzichtsbestand.

– of –

Er is een fout opgetreden bij het parseren van het virtuele pad dat is opgegeven voor het siteMapFile kenmerk.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een nieuw exemplaar van de XmlSiteMapProvider klasse maakt en initialiseert om een siteoverzicht te maken op basis van XML-gegevens.

<%@ Page Language="c#" %>
<SCRIPT runat="server">
 private void Page_Load(object sender, System.EventArgs e) {
     // Create an instance of the XmlSiteMapProvider class.
     XmlSiteMapProvider testXmlProvider = new XmlSiteMapProvider();
     NameValueCollection providerAttributes = new NameValueCollection(1);
     providerAttributes.Add("siteMapFile","test.sitemap");

     // Initialize the provider with a provider name and file name.
     testXmlProvider.Initialize("testProvider", providerAttributes);

     // Call the BuildSiteMap to load the site map information into memory.
     testXmlProvider.BuildSiteMap();

     // Prints "/myvirtualdirectory/WebForm1.aspx"
     Response.Write(testXmlProvider.RootNode.Url + "<BR>");

     // Prints "/myvirtualdirectory/WebForm2.aspx"
     Response.Write(testXmlProvider.CurrentNode.Url + "<BR>");
 }
 </SCRIPT>

In het voorgaande codevoorbeeld wordt een XML-bestand gebruikt dat zich in de virtuele hoofdmap van de ASP.NET-toepassing bevindt. Het bestand heeft de volgende indeling:

<siteMap>
  <siteMapNode title="RootNode" description="The root page." url="WebForm1.aspx">
    <siteMapNode title="CurrentNode" description="Some sub page." url="WebForm2.aspx"/>
  </siteMapNode>
</siteMap>

Opmerkingen

De XmlSiteMapProvider klasse overschrijft de overgenomen Initialize methode om verschillende kenmerken, zoals de siteMapFile en description kenmerken, toe te passen op de attributes verzameling.

Van toepassing op

Zie ook