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

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

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

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

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

特性和元素

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

特性

特性

说明

defaultProvider

必需的特性。

指定提供程序的名称。

默认值为 XmlSiteMapProvider 提供程序。

子元素

元素

说明

providers

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

父元素

元素

说明

configuration

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

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 信息服务 (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