共用方式為


SiteMapPath Web 伺服器控制項概觀

更新:2007 年 11 月

SiteMapPath 會顯示巡覽路徑 (也稱為麵包屑或眉毛),巡覽路徑顯示使用者目前的頁面位置和返回首頁的路徑連結。

這個主題包含:

  • 背景

  • 程式碼範例

  • 類別參考

背景

SiteMapPath 控制項可從網站導覽取得巡覽資料。這個資料包含您網站中各頁面的相關資訊,例如 URL、標題、描述和在巡覽階層架構中的位置。將巡覽資料儲存在一個地方,比較容易在網站的巡覽功能表中加入和移除項目。

下列程式碼範例顯示 Web.sitemap 檔中所包含的網站導覽資料。

<siteMap>
  <siteMapNode title="Home" description="Home" url="~/default.aspx" >
    <siteMapNode title="Services" description="Services we offer" 
      url="~/Services.aspx">
    <siteMapNode title="Training" description="Training classes" 
      url="~/Training.aspx" />
    <siteMapNode title="Consulting" description="Consulting services" 
      url="~/Consulting.aspx" />
    </siteMapNode>
  </siteMapNode>
</siteMap>
注意事項:

只有網站導覽所列示的頁面可以在 SiteMapPath 控制項中顯示巡覽資料。如果您將 SiteMapPath 控制項放在網站導覽未列出的頁面上,控制項就不會對用戶端顯示任何資訊。

您可以加入下列程式碼,將 SiteMapPath 控制項加入至 Training.aspx 頁面。

<asp:SiteMapPath ID="SiteMapPath1" Runat="server"></asp:SiteMapPath>

在瀏覽器中檢視 Training.aspx 頁面時,SiteMapPath 控制項會顯示內容如下,其中的 Home 和 Services 會以超連結 (Hyperlink) 形式呈現:

        Home > Services > Training

您可以使用 SiteMapPath 控制項來建立網站巡覽,而不需程式碼和繫結資料。控制項可以自動讀取和轉譯網站導覽資訊。不過,您也可以視需要使用 SiteMapPath 控制項來改變網站導覽資料。如需詳細資訊,請參閱 HOW TO:在記憶體中以程式設計方式修改網站導覽節點

使用者可以使用 SiteMapPath 控制項,從目前的頁面向後巡覽至網站階層中的較高頁面。不過,您無法使用 SiteMapPath 控制項,從目前的頁面向前巡覽至網站階層中的較低頁面。例如,您可以在新聞群組或留言板應用程式中使用 SiteMapPath 控制項,讓使用者查看目前正在瀏覽的文章路徑。

程式碼範例

HOW TO:加入簡單的網站巡覽

HOW TO:自訂 SiteMapPath Web 伺服器控制項的外觀

HOW TO:設定多個網站導覽和網站導覽提供者

回到頁首

類別參考

下表列出 SiteMapPath 控制項的相關類別。

成員

描述

SiteMapPath

控制項的主要類別。

回到頁首

請參閱

工作

HOW TO:自訂 SiteMapPath Web 伺服器控制項的外觀

HOW TO:篩選 SiteMapDataSource Web 伺服器控制項擷取的節點

概念

ASP.NET 網站巡覽概觀

設定 ASP.NET 網站巡覽的安全性

設定資料存取的安全性

參考

SiteMapPath

XmlSiteMapProvider

其他資源

裝載環境中 ASP.NET 應用程式的安全性