XmlSiteMapProvider.Initialize(String, NameValueCollection) 方法

定義

命名空間:

System.Web

組件:

System.Web.dll

初始化 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 組態讀取這些屬性。

例外狀況

InvalidOperationException

XmlSiteMapProvider 已多次初始化。

HttpException

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 的方法，將數個屬性，例如 siteMapFile 和 description 屬性套用至 attributes 集合。

另請參閱

• BuildSiteMap()
• Clear()