XmlSiteMapProvider.Initialize(String, NameValueCollection) Methode

Definition

Initialisiert das XmlSiteMapProvider-Objekt.Initializes the XmlSiteMapProvider object. Die Initialize(String, NameValueCollection)-Methode erstellt nicht direkt eine Siteübersicht. Sie bereitet lediglich den Zustand des XmlSiteMapProvider dafür vor.The Initialize(String, NameValueCollection) method does not actually build a site map, it only prepares the state of the XmlSiteMapProvider to do so.

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.The XmlSiteMapProvider to initialize.

attributes
NameValueCollection

Eine NameValueCollection, die zusätzliche Attribute enthalten kann, um das Initialisieren des name zu unterstützen.A NameValueCollection that can contain additional attributes to help initialize name. Diese Attribute werden aus der XmlSiteMapProvider-Konfiguration in der Datei Web.config gelesen.These attributes are read from the XmlSiteMapProvider configuration in the Web.config file.

Ausnahmen

Der XmlSiteMapProvider wird mehr als einmal initialisiert.The XmlSiteMapProvider is initialized more than once.

Ein SiteMapNode hat einen physikalischen Pfad verwendet, um auf eine Siteübersichtsdatei zu verweisen.A SiteMapNode used a physical path to reference a site map file.

- oder --or- Beim Analysieren des für das siteMapFile-Attribut angegebenen virtuellen Pfads ist ein Fehler aufgetreten.An error occurred while attempting to parse the virtual path supplied for the siteMapFile attribute.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine neue Instanz der XmlSiteMapProvider -Klasse erstellt und initialisiert wird, um eine Site Map aus XML-Daten zu erstellen.The following code example demonstrates how to create a new instance of the XmlSiteMapProvider class and initialize it to build a site map from XML data.

<%@ 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 vorangehenden Codebeispiel wird eine XML-Datei verwendet, die sich im virtuellen Stammverzeichnis der ASP.NET-Anwendung befindet.The preceding code example uses an XML file that is located in the virtual root of the ASP.NET application. Die Datei weist das folgende Format auf:The file has the following 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 Initialize geerbte-Methode, um mehrere Attribute ( siteMapFile z description . b. die attributes Attribute und) auf die Auflistung anzuwenden.The XmlSiteMapProvider class overrides the inherited Initialize method to apply several attributes, such as the siteMapFile and description attributes, to the attributes collection.

Gilt für:

Siehe auch