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: Lock ASP.NET Configuration Settings

參考

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

<configuration> 項目

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

System.Configuration

System.Web.Configuration

概念

ASP.NET Configuration Overview

ASP.NET Server Controls and Browser Capabilities

Securing Configuration

Configuration Inheritance

其他資源

ASP.NET Configuration Files

ASP.NET 組態設定

一般組態設定 (ASP.NET)

ASP.NET Configuration API