XmlSiteMapProvider.Initialize(String, NameValueCollection) XmlSiteMapProvider.Initialize(String, NameValueCollection) XmlSiteMapProvider.Initialize(String, NameValueCollection) XmlSiteMapProvider.Initialize(String, NameValueCollection) Method

定義

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.

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 String String String

初期化する XmlSiteMapProviderThe XmlSiteMapProvider to initialize.

attributes
NameValueCollection NameValueCollection NameValueCollection NameValueCollection

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.

例外

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);  
     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 ファイルを使用します。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:

<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かの属性をコレクションに適用します。The XmlSiteMapProvider class overrides the inherited Initialize method to apply several attributes, such as the siteMapFile and description attributes, to the attributes collection.

適用対象

こちらもご覧ください