siteMap 的 providers 元素(ASP.NET 设置架构)

[本文档仅供预览,在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

定义导航提供程序的集合。

此元素是 .NET Framework 2.0 版中的新元素。

<providers> 
  <add.../> 
  <remove.../> 
  <clear/> 
</providers>

特性和元素

以下几节描述了特性、子元素和父元素。

特性

无。

子元素

元素

说明

add

可选元素。

向导航提供程序的集合中添加提供程序。

clear

可选元素。

清除以前定义的所有提供程序。

remove

可选元素。

从导航提供程序的集合中移除提供程序。

父元素

元素

说明

configuration

指定公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。

system.web

为 ASP.NET 配置节指定根元素。

siteMap

定义配置设置以支持用于配置、存储和呈现站点导航的导航基础结构。

备注

默认配置

下面的默认 providers 元素在 .NET Framework 版本 2.0 的根 Web.config 文件中配置。

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

示例

下面的代码示例演示如何在 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

配置成员

SiteMapSection.Providers

可配置的位置

Machine.config

根级别的 Web.config

应用程序级别的 Web.config

要求

Microsoft Internet 信息服务 (IIS) 版本 5.0、5.1 或 6.0

.NET Framework 2.0 版

Microsoft Visual Studio 2005

请参见

任务

How to: Lock ASP.NET Configuration Settings

参考

siteMap 元素(ASP.NET 设置架构)

system.web 元素(ASP.NET 设置架构)

<configuration> 元素

siteMap 的 providers 的 add 元素(ASP.NET 设置架构)

siteMap 的 providers 的 clear 元素(ASP.NET 设置架构)

siteMap 的 providers 的 remove 元素(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