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>
元素信息
配置节处理程序 |
|
配置成员 |
|
可配置的位置 |
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 的 providers 元素(ASP.NET 设置架构)
概念
ASP.NET Configuration Overview
ASP.NET Server Controls and Browser Capabilities