Элемент siteMap (схема параметров ASP.NET)

Определяет параметры для поддержки навигационной инфраструктуры для настройки, хранения и визуализации структуры переходов веб-узла.

Этот элемент не использовался до .NET Framework версии 2.0.

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

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут

Описание

defaultProvider

Обязательный атрибут.

Задает имя поставщика.

По умолчанию — это поставщик XmlSiteMapProvider.

Дочерние элементы

Элемент

Описание

providers

Определяет коллекцию поставщиков навигации.

Родительские элементы

Элемент

Описание

configuration

Задает обязательный корневой элемент любого файла конфигурации, который используется средой CLR и приложениями .NET Framework.

system.web

Задает корневой элемент для раздела конфигурации ASP.NET.

Заметки

Параметры по умолчанию

Для .NET Framework версии 2.0 следующий элемент по умолчанию siteMap настраивается в корневом файле 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 IIS версии 5.0, 5.1 или 6.0

.NET Framework версии 2.0

Microsoft Visual Studio 2005

См. также

Задачи

Пошаговое руководство. Отключение параметров конфигурации ASP.NET

Ссылки

Элемент system.web (схема параметров ASP.NET)

Элемент <configuration>

Элемент providers для элемента siteMap (схема параметров ASP.NET)

System.Configuration

System.Web.Configuration

Основные понятия

Общие сведения о конфигурационном ASP.NET

Серверные веб-элементы управления ASP.NET и возможности обозревателей

Настройка обеспечения безопасности ASP.NET

Сценарии конфигурации ASP.NET

Другие ресурсы

Файлы конфигурации ASP.NET

Параметры конфигурации ASP.NET

Общие параметры конфигурации (ASP.NET)

Конфигурационный API-интерфейс настройки ASP.NET