向导航提供程序的集合添加提供程序。
此元素是 .NET Framework 2.0 版中的新元素。
configuration 元素（常规设置架构）??system.web 元素（ASP.NET 设置架构）
????siteMap 元素（ASP.NET 设置架构）
??????siteMap 的 providers 元素（ASP.NET 设置架构）
????????siteMap 的 providers 的 add 元素（ASP.NET 设置架构）
<add name="provider name" type="provider type" description="description" siteMapFile="path" /> |
属性和元素
下面几部分描述了属性、子元素和父元素。
属性
| 属性 | 说明 |
|---|---|
|
description |
必选的 描述站点地图提供程序。 |
|
name |
必选的 String 属性。 指定要添加的提供程序的名称。 |
|
siteMapFile |
可选的 String 属性。 指定包含站点地图数据的文件。siteMapFile 引用可以是以下任何一项：
|
|
type |
必选的 String 属性。 指定用于实现 type 值必须是完全限定的程序集引用。 |
|
securityTrimmingEnabled |
默认为 false。 如果为 true 并且提供程序包括必要的逻辑，则站点地图提供程序对已检索的节点执行角色检查。提供程序还对当前用户执行角色检查。应用针对应用程序的 URL 授权规则，并且如果使用 Microsoft Windows 身份验证，还将应用针对应用程序的文件授权规则。 |
子元素
无。
父元素
| 元素 | 说明 |
|---|---|
|
configuration |
提供公共语言运行库和 .NET Framework 应用程序使用的每个配置文件中的根元素。 |
|
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 信息服务 (IIS) 版本 5.0、5.1 或 6.0 .NET Framework 2.0 版 Microsoft Visual Studio 2005 |
请参见
任务
参考
siteMap 的 providers 元素（ASP.NET 设置架构）siteMap 元素（ASP.NET 设置架构）
system.web 元素（ASP.NET 设置架构）
siteMap 的 providers 的 clear 元素（ASP.NET 设置架构）
siteMap 的 providers 的 remove 元素（ASP.NET 设置架构）
概念
其他资源
ASP.NET 配置设置
常规配置设置 (ASP.NET)
