XmlSiteMapProvider.Initialize(String, NameValueCollection) Methode

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

Initialisiert das XmlSiteMapProvider-Objekt. Die Initialize(String, NameValueCollection)-Methode erstellt nicht direkt eine Siteübersicht. Sie bereitet lediglich den Zustand des XmlSiteMapProvider dafür vor.

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)

Parameter

name

String

Die zu initialisierende XmlSiteMapProvider.

attributes

NameValueCollection

Eine NameValueCollection, die zusätzliche Attribute enthalten kann, um das Initialisieren des name zu unterstützen. Diese Attribute werden aus der XmlSiteMapProvider-Konfiguration in der Datei Web.config gelesen.

Ausnahmen

InvalidOperationException

Der XmlSiteMapProvider wird mehr als einmal initialisiert.

HttpException

Ein SiteMapNode hat einen physikalischen Pfad verwendet, um auf eine Siteübersichtsdatei zu verweisen.

- oder -

Beim Analysieren des für das siteMapFile-Attribut angegebenen virtuellen Pfads ist ein Fehler aufgetreten.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie eine neue Instanz der XmlSiteMapProvider -Klasse erstellen und initialisieren, um eine Siteübersicht aus XML-Daten zu erstellen.

<%@ 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>  

Im vorherigen Codebeispiel wird eine XML-Datei verwendet, die sich im virtuellen Stammverzeichnis der ASP.NET-Anwendung befindet. Die Datei hat das folgende Format:

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

Hinweise

Die XmlSiteMapProvider -Klasse überschreibt die geerbte Initialize Methode, um mehrere Attribute, z. B. die siteMapFile Attribute und description , auf die attributes Auflistung anzuwenden.

Weitere Informationen

• BuildSiteMap()
• Clear()