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檔案可讓 SiteMapDataSource 控制項使用自訂 SiteMapProvider 物件：

<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檔案範例參考的類別程式 SiteMapProvider 代碼 SimpleTextSiteMapProvider 。 如果您使用 Visual Basic 範例，命名空間會以 「VB」 而非 「CS」 結尾。 您也可以在類別概觀中找到 「text.txt」 網站地圖檔案的 SiteMapProvider 範例內容。

注意

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 會儲存在檢視狀態中。

適用於

另請參閱