Aracılığıyla paylaş

XmlSiteMapProvider.Initialize(String, NameValueCollection) Yöntem

  • Başvuru

Tanım

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

nesnesini XmlSiteMapProvider başlatıyor. yöntemi Initialize(String, NameValueCollection) aslında bir site haritası oluşturmaz, yalnızca durumunu bunu yapmak için 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

XmlSiteMapProviderBaşlatılmayacak.

attributes
NameValueCollection

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

Özel durumlar

InvalidOperationException

XmlSiteMapProviderbirden çok kez başlatılır.

HttpException

Bir SiteMapNode site haritası dosyasına başvuru yapmak için fiziksel bir yol kullandı.

-veya- özniteliği için sağlanan sanal yolu ayrıştırmaya çalışırken bir hata siteMapFile oluştu.

Örnekler

Aşağıdaki kod örneği, sınıfının yeni bir örneğini oluşturma ve XML verilerinden bir site haritası XmlSiteMapProvider derlemek için bunu başlatmayı 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, uygulamanın sanal kökünde bulunan bir XML ASP.NET kullanır. Dosya aşağıdaki biçime sahip:

<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ı, ve öznitelikleri gibi birkaç özniteliği koleksiyona uygulamak XmlSiteMapProvider için Initialize siteMapFile devralınan yöntemi geçersiz description attributes kılar.

Şunlara uygulanır

Ayrıca bkz.