共用方式為


XmlSiteMapProvider.Initialize(String, NameValueCollection) 方法

定義

初始化 XmlSiteMapProvider 物件。 Initialize(String, NameValueCollection) 方法不會實際建置網站地圖,而只會準備 XmlSiteMapProvider 的狀態以執行這項作業。

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)

參數

name
String

要初始化的 XmlSiteMapProvider

attributes
NameValueCollection

NameValueCollection,可以包含用來協助初始化 name 的其他屬性。 系統會從 Web.config 檔中的 XmlSiteMapProvider 組態讀取這些屬性。

例外狀況

SiteMapNode 使用實體路徑參考網站地圖檔案。

-或-

嘗試剖析提供給 siteMapFile 屬性的虛擬路徑時發生錯誤。

範例

下列程式碼範例示範如何建立 類別的新實例 XmlSiteMapProvider ,並將其初始化,以從 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>  

上述程式碼範例會使用位於 ASP.NET 應用程式的虛擬根目錄中的 XML 檔案。 檔案的格式如下:

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

備註

類別 XmlSiteMapProvider 會覆寫繼承 Initialize 的方法,將數個屬性,例如 siteMapFiledescription 屬性套用至 attributes 集合。

適用於

另請參閱