將提供者加入巡覽提供者的集合。
這個項目是 .NET Framework 2.0 版中新增的項目。
<add
name="provider name"
type="provider type"
description="description"
siteMapFile="path"
/>
屬性和項目
下列章節會說明屬性 (Attribute)、子項目和父項目。
屬性
屬性 |
描述 |
|---|---|
description |
必要的 String 屬性。 說明網站導覽提供者。 |
name |
必要的 String 屬性。 指定要加入的提供者名稱。 |
siteMapFile |
選擇性 String 屬性。 指定包含網站導覽資料的檔案。 siteMapFile 參考可以是下列其中之一：
|
type |
必要的 String 屬性。 指定實作 ProviderBase 類別的型別。 type 值必須是完整的組件 (Assembly) 參考。 |
securityTrimmingEnabled |
預設值為 false。 如果為 true，而且提供者包含必要的邏輯，網站導覽提供者便會針對擷取的節點執行角色檢查。 提供者也會對目前使用者執行角色檢查。 如果使用 Microsoft Windows 驗證，就會套用應用程式的 URL 授權規則，並且也會套用應用程式的檔案授權規則。 |
子項目
無。
父項目
項目 |
描述 |
|---|---|
configuration |
提供 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中的根項目 (Root Element)。 |
system.web |
指定 ASP.NET 組態區段的根項目。 |
siteMap |
定義組態設定，支援設定、儲存和呈現網站巡覽所需的巡覽基礎結構。 |
providers |
定義巡覽提供者的集合。 |
備註
預設的組態
下列預設的 add 項目是在 .NET Framework 2.0 版中的根 Web.config 檔中設定。
<add siteMapFile="web.sitemap" name="AspNetXmlSiteMapProvider"
type="System.Web.XmlSiteMapProvider, System.Web, Version=2.0.0.0, Culture=neutral,
PublicKeyToken=b03f5f7f11d50a3a" />
範例
下列程式碼範例中，會顯示如何在 Web.config 檔案中加入網站導覽提供者，以覆寫為 ASP.NET 定義的預設網站導覽提供者。
<configuration>
<system.web>
<siteMap>
<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>
項目資訊
組態區段處理常式 |
|
組態成員 |
|
可設定的位置 |
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 |
請參閱
工作
參考
siteMap 的 providers 項目 (ASP.NET 設定結構描述)
system.web 項目 (ASP.NET 設定結構描述)
siteMap 提供者的 clear 項目 (ASP.NET 設定結構描述)
siteMap 提供者的 remove 項目 (ASP.NET 設定結構描述)