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

Статья
08/11/2011

Добавляет поставщика в коллекцию поставщиков навигации.

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

<add  
   name="provider name" 
   type="provider type"
   description="description"
   siteMapFile="path"
/>

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

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

Атрибуты

Атрибут	Описание
description	Обязательный атрибут элемента String. Содержит описание поставщика карты узла.
name	Обязательный атрибут элемента String. Задает имя поставщика, которого необходимо добавить.
siteMapFile	Необязательный атрибут: String. Задает файл, содержащий данные карты узла. Аргумент siteMapFile может представлять одну из следующих ссылок: Ссылка на относительный путь приложения (например, ~/SiteMapFile1.sitemap). Виртуальный путь к папке в структуре каталогов приложения (например, /directory1/directory2/SiteMapFile1.sitemap). Ссылка на относительный путь к корню структуры каталогов приложения (например, SiteMapFile1.sitemap.
type	Обязательный атрибут: String. Задает тип, реализующий класс ProviderBase . Значение type должно представлять собой полную ссылку на сборку.
securityTrimmingEnabled	По умолчанию используется значение false. Если атрибут принимает значение true, и поставщик включает необходимую логику, поставщик карты узла выполняет проверку роли на извлеченных узлах. Поставщик также проверяет роль текущего пользователя. Применяются правила авторизации URL-адреса приложения, и, если используется проверка подлинности Microsoft Windows, применяются также правила авторизации файлов приложения.

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

Отсутствует.

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

Элемент	Описание
configuration	Предоставляет корневой элемент любого файла конфигурации, используемого средой CLR и приложениями .NET Framework.
system.web	Задает корневой элемент для раздела конфигурации ASP.NET.
siteMap	Определяет параметры для поддержки навигационной инфраструктуры для настройки, хранения и визуализации структуры переходов веб-узла.
providers	Определяет коллекцию поставщиков навигации.

Заметки

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

В корневом файле Web.config в .NET Framework версии 2.0 по умолчанию задан следующий элемент add.

<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>

Сведения об элементе

Обработчик раздела конфигурации	System.Web.Configuration.SiteMapSection
Элемент конфигурации	SiteMapSection.Providers
Настраиваемые расположения	Machine.config Файл Web.config корневого уровня Файл Web.config уровня приложения
Требования	Microsoft IIS версии 5.0, 5.1 или 6.0 Платформа .NET Framework версии 2.0 Microsoft Visual Studio 2005

См. также

Поделиться через

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

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

Атрибуты

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

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

Заметки

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

Пример

Сведения об элементе

См. также

Задачи

Ссылки

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

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

Дополнительные ресурсы