siteMap 項目 (ASP.NET 設定結構描述)

定義組態設定,支援設定、儲存和呈現網站巡覽所需的巡覽基礎結構。

這個項目是 .NET Framework 2.0 版中新增的項目。

<siteMap
  defaultProvider="provider name">
  <providers>...</providers> 
</siteMap>

屬性和項目

下列各節將說明屬性、子項目和父項目。

屬性

屬性

描述

defaultProvider

必要屬性。

指定提供者的名稱。

預設為 XmlSiteMapProvider 提供者。

子項目

項目

描述

providers

定義巡覽提供者的集合。

父項目

項目

描述

configuration

指定 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中需要的根項目 (Root Element)。

system.web

指定 ASP.NET 組態區段的根項目。

備註

預設的組態

下列預設的 siteMap 項目是在 .NET Framework 2.0 版中的根 Web.config 檔中設定。

<siteMap>
     <providers>
           <add siteMapFile="web.sitemap" name="AspNetXmlSiteMapProvider"
                type="System.Web.XmlSiteMapProvider, System.Web, Version=2.0.0.0, Culture=neutral, 
                PublicKeyToken=b03f5f7f11d50a3a" />
     </providers>
</siteMap>

範例

下列程式碼範例中,會顯示如何在 Web.config 檔案中加入網站導覽提供者,以覆寫為 ASP.NET 定義的預設網站導覽提供者。

<configuration>
  <system.web>
    <siteMap defaultProvider="XmlSiteMapReader">
      <providers>
        <add 
          name=" XmlSiteMapReader"
          type="XmlSiteMapProvider, System.Web, Version=1.1.3300.0,
                Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"
          siteMapFile="my.sitemap" 
          description="XmlSiteMapProvider that loads my.sitemap"/>
      </providers>
    </siteMap>
  </system.web>
</configuration>

項目資訊

組態區段處理常式

System.Web.Configuration.SiteMapSection

組態成員

SystemWebSectionGroup.SiteMap

可設定的位置

Machine.config

根層次的 Web.config

應用程式層級的 Web.config

需求

Microsoft Internet Information Services (IIS) 5.0、5.1 或 6.0 版

.NET Framework 2.0 版

Microsoft Visual Studio 2005

請參閱

工作

HOW TO:鎖定 ASP.NET 組態設定

參考

system.web 項目 (ASP.NET 設定結構描述)

<configuration> 項目

siteMap 的 providers 項目 (ASP.NET 設定結構描述)

System.Configuration

System.Web.Configuration

概念

ASP.NET 組態概觀

ASP.NET Web 伺服器控制項和瀏覽器能力

保護 ASP.NET 組態

ASP.NET 組態案例

其他資源

ASP.NET 組態檔

ASP.NET 組態設定

一般組態設定 (ASP.NET)

ASP.NET 組態 API