XmlSiteMapProvider.Initialize(String, NameValueCollection) メソッド


XmlSiteMapProvider オブジェクトを初期化します。Initializes the XmlSiteMapProvider object. Initialize(String, NameValueCollection) メソッドは、実際のサイト マップ構築は行わず、構築するための XmlSiteMapProvider の状態を準備するだけです。The Initialize(String, NameValueCollection) method does not actually build a site map, it only prepares the state of the XmlSiteMapProvider to do so.

 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)



初期化する XmlSiteMapProviderThe XmlSiteMapProvider to initialize.


name の初期化を支援する追加属性を含む NameValueCollectionA NameValueCollection that can contain additional attributes to help initialize name. これらの属性は、Web.config ファイルの XmlSiteMapProvider 構成から読み取られます。These attributes are read from the XmlSiteMapProvider configuration in the Web.config file.


XmlSiteMapProvider が何度も初期化されています。The XmlSiteMapProvider is initialized more than once.

SiteMapNode が、サイト マップ ファイルの参照時に物理パスを使用しました。A SiteMapNode used a physical path to reference a site map file.

または-or- siteMapFile 属性で示された仮想パスの解析試行時にエラーが発生しました。An error occurred while attempting to parse the virtual path supplied for the siteMapFile attribute.

次のコード例は、クラスの新しいインスタンスを作成 XmlSiteMapProvider して初期化し、XML データからサイトマップを構築する方法を示しています。The following code example demonstrates how to create a new instance of the XmlSiteMapProvider class and initialize it to build a site map from XML data.

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

     // 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.  

     // Prints "/myvirtualdirectory/WebForm1.aspx"  
     Response.Write(testXmlProvider.RootNode.Url + "<BR>");  

     // Prints "/myvirtualdirectory/WebForm2.aspx"  
     Response.Write(testXmlProvider.CurrentNode.Url + "<BR>");  

上記のコード例では、ASP.NET アプリケーションの仮想ルートにある XML ファイルを使用します。The preceding code example uses an XML file that is located in the virtual root of the ASP.NET application. ファイルの形式は次のとおりです。The file has the following format:

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


クラスは、継承された XmlSiteMapProvider メソッドをオーバーライド Initialize して、属性や属性など、いくつかの属性を siteMapFile description コレクションに適用し attributes ます。The XmlSiteMapProvider class overrides the inherited Initialize method to apply several attributes, such as the siteMapFile and description attributes, to the attributes collection.