XmlSiteMapProvider.Initialize(String, NameValueCollection) Methode

Definition

Namespace:
System.Web
Assembly:
System.Web.dll

Initialisiert das XmlSiteMapProvider-Objekt. Die Initialize(String, NameValueCollection) Methode erstellt nicht tatsächlich eine Websitekarte, sondern bereitet nur den Zustand des XmlSiteMapProvider Vorgangs 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

Der XmlSiteMapProvider zu initialisierende Code.

attributes
NameValueCollection

A NameValueCollection that can contain additional attributes to help initialize name. Diese Attribute werden aus der Konfiguration in der XmlSiteMapProvider datei Web.config gelesen.

Ausnahmen

InvalidOperationException

Die XmlSiteMapProvider Initialisierung erfolgt mehrmals.

HttpException

A SiteMapNode used a physical path to reference a site map file.

-oder-

Fehler beim Analysieren des virtuellen Pfads für das siteMapFile Attribut.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine neue Instanz der XmlSiteMapProvider Klasse erstellt und initialisiert wird, um eine Websitezuordnung 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 Stamm der ASP.NET-Anwendung befindet. Die Datei weist das folgende Format auf:

<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 setzt die geerbte Initialize Methode außer Kraft, um mehrere Attribute, z. B. die siteMapFile Attribute description , auf die attributes Auflistung anzuwenden.

Gilt für:

Weitere Informationen