XmlSiteMapProvider.Initialize(String, NameValueCollection) Yöntem

Tanım

Ad Alanı:
System.Web
Bütünleştirilmiş Kod:
System.Web.dll

Nesnesini başlatır XmlSiteMapProvider . Initialize(String, NameValueCollection) yöntemi aslında bir site haritası oluşturmaz, bunu yapmak için yalnızca durumunu XmlSiteMapProvider hazırlar.

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)

Parametreler

name
String

XmlSiteMapProvider başlatacak.

attributes
NameValueCollection

NameValueCollection başlatmaya nameyardımcı olmak için ek öznitelikler içerebilen bir. Bu öznitelikler Web.config dosyasındaki yapılandırmadan XmlSiteMapProvider okunur.

Özel durumlar

InvalidOperationException

XmlSiteMapProvider birden çok kez başlatılır.

HttpException

Bir SiteMapNode site haritası dosyasına başvurmak için kullanılan fiziksel yol.

-veya-

Özniteliği için siteMapFile sağlanan sanal yol ayrıştırmaya çalışılırken bir hata oluştu.

Örnekler

Aşağıdaki kod örneği, sınıfın yeni bir örneğinin XmlSiteMapProvider nasıl oluşturulacağını ve XML verilerinden bir site haritası oluşturmak için nasıl başlatacağını gösterir.

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

Yukarıdaki kod örneği, ASP.NET uygulamasının sanal kökünde bulunan bir XML dosyası kullanır. Dosya aşağıdaki biçime sahiptir:

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

Açıklamalar

sınıfı devralınan XmlSiteMapProvider yöntemi geçersiz kılarak Initialize ve siteMapFile öznitelikleri gibi description çeşitli öznitelikleri koleksiyona attributes uygular.

Şunlara uygulanır

Ayrıca bkz.