SiteMapDataSource.SiteMapProvider 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定資料來源所繫結的網站導覽提供者名稱。
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
屬性值
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 會儲存在檢視狀態中。