XmlSiteMapProvider.Initialize(String, NameValueCollection) Metoda

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

Inicializuje XmlSiteMapProvider objekt. Metoda Initialize(String, NameValueCollection) ve skutečnosti nevystaví mapu webu, připraví pouze stav, který XmlSiteMapProvider má provést.

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)

Parametry

name

String

Inicializace XmlSiteMapProvider .

attributes

NameValueCollection

A NameValueCollection , který může obsahovat další atributy, které pomáhají inicializovat name. Tyto atributy se čtou XmlSiteMapProvider z konfigurace v souboru Web.config.

Výjimky

InvalidOperationException

Inicializuje XmlSiteMapProvider se více než jednou.

HttpException

Použitá SiteMapNode fyzická cesta k odkazu na soubor mapy webu.

nebo

Při pokusu o parsování virtuální cesty zadané pro siteMapFile atribut došlo k chybě.

Příklady

Následující příklad kódu ukazuje, jak vytvořit novou instanci XmlSiteMapProvider třídy a inicializovat ji k sestavení mapy webu z dat XML.

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

Předchozí příklad kódu používá soubor XML umístěný ve virtuálním kořenovém adresáři aplikace ASP.NET. Soubor má následující formát:

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

Poznámky

Třída XmlSiteMapProvider přepíše zděděnou Initialize metodu pro použití několika atributů, jako siteMapFile jsou například atributy description , na kolekci attributes .

Viz také

• BuildSiteMap()
• Clear()