SiteMapDataSource.SiteMapProvider プロパティ

定義

名前空間:
System.Web.UI.WebControls
アセンブリ:
System.Web.dll

データ ソースがバインドされるサイト マップ プロバイダーの名前を取得または設定します。

public:
 virtual property System::String ^ SiteMapProvider { System::String ^ get(); void set(System::String ^ value); };
public virtual string SiteMapProvider { get; set; }
member this.SiteMapProvider : string with get, set
Public Overridable Property SiteMapProvider As String

プロパティ値

String

SiteMapDataSourceがバインドされるサイト マップ プロバイダーの名前。 既定では、値は Emptyされ、サイトの既定のサイト マップ プロバイダーが使用されます。

例

次のコード例では、既定のプロバイダー以外のTreeView オブジェクトによって提供されるサイト マップ データにSiteMapProvider コントロールを宣言によってバインドする方法を示します。 Web.config ファイルを使用すると、SiteMapProvider コントロールでカスタム SiteMapDataSource オブジェクトを使用できるようになります。

<system.web>
  <siteMap>
    <providers>
      <add name="AsciiTextProvider"
        description="SiteMap provider which reads in .sitemap text files."
        type="Samples.AspNet.CS.SimpleTextSiteMapProvider"
      siteMapFile="test.txt"/>
    </providers>
  </siteMap>
</system.web>

この Web.config ファイルの例で参照する SimpleTextSiteMapProvider クラスのコードは、 SiteMapProvider クラスの概要で確認できます。 Visual Basic の例を使用する場合、名前空間は "CS" ではなく "VB" で終わります。 SiteMapProvider クラスの概要で、"text.txt" サイト マップ ファイルのサンプル コンテンツを見つけることもできます。

Note

AsciiTextProviderはサイトの既定のプロバイダーではなく、(この場合は) XmlSiteMapProvider オブジェクトのままです。 SiteMapProvider コントロールの SiteMapDataSource プロパティはカスタム サイト マップ プロバイダーの名前に設定され、TreeViewは対応するサイト マップ データにバインドされます。

<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">
            <asp:SiteMapDataSource
                id="SiteMapDataSource1"
                runat="server"
                SiteMapProvider="AsciiTextProvider" />

            <asp:TreeView
                id="TreeView1"
                runat="server"
                DataSourceID="SiteMapDataSource1">
            </asp:TreeView>

        </form>
    </body>
</html>

<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">
            <asp:SiteMapDataSource
                id="SiteMapDataSource1"
                runat="server"
                SiteMapProvider="AsciiTextProvider" />

            <asp:TreeView
                id="TreeView1"
                runat="server"
                DataSourceID="SiteMapDataSource1">
            </asp:TreeView>

        </form>
    </body>
</html>

注釈

SiteMapProvider プロパティの値はビュー ステートに格納されます。

適用対象

こちらもご覧ください