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

Обновлен: Ноябрь 2007

Добавляет псевдонимы указанных агентов пользователя во внутреннюю коллекцию псевдонимов агентов пользователя.

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

<clientTarget> 
   <add... />
   <remove... />
   <clear/>
</clientTarget>

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

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

Атрибуты

Нет.

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

Элемент

Описание

add

Необязательный элемент.

Добавляет псевдоним определенного агента пользователя во внутреннюю коллекцию псевдонимов агентов пользователя.

clear

Необязательный элемент.

Удаляет все псевдонимы, которые на данный момент содержатся в файле Web.config или наследуются из него.

remove

Необязательный элемент.

Удаляет псевдоним определенного агента пользователя из внутренней коллекции псевдонимов агентов пользователя. Значение должно точно совпадать со значением предыдущей директивы add. Значения на основе подстановок не поддерживаются.

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

Элемент

Описание

configuration

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

system.web

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

Заметки

Коллекция псевдонимов агентов пользователя задает конечных агентов, для которых содержимое должно отображаться серверными элементами управления ASP.NET.

Настройки по умолчанию

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

<clientTarget>
     <add alias="ie5" userAgent="Mozilla/4.0 (compatible; MSIE 5.5; Windows NT 4.0" />
     <add alias="ie4" userAgent="Mozilla/4.0 (compatible; MSIE 4.0; Windows NT 4.0" />
     <add alias="uplevel" userAgent="Mozilla/4.0 (compatible; MSIE 5.5; Windows NT 5.1)" />
     <add alias="downlevel" userAgent="Generic Downlevel" />
</clientTarget>

В .NET Framework версий 1.0 и 1.1 в файле Machine.config по умолчанию задан элемент clientTarget.

<clientTarget>
     <add alias="ie5" userAgent="Mozilla/4.0 (compatible; MSIE 5.5; Windows NT 4.0)"/>
     <add alias="ie4" userAgent="Mozilla/4.0 (compatible; MSIE 4.0; Windows NT 4.0)"/>
     <add alias="uplevel" userAgent="Mozilla/4.0 (compatible; MSIE 4.0; Windows NT 4.0)"/>
     <add alias="downlevel" userAgent="Unknown"/>
</clientTarget>

Пример

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

<configuration>
   <system.web>
      <clientTarget>
         <add alias="ie5" userAgent="Mozilla/4.0 (compatible;MSIE 5.5;Windows NT 4.0)"/>
         <add alias="ie4" userAgent="Mozilla/4.0 (compatible;MSIE 4.0;Windows NT 4.0)"/>
         <add alias="uplevel" userAgent="Mozilla/4.0 (compatible;MSIE 4.0;Windows NT 4.0)"/>
         <add alias="downlevel" userAgent="Unknown"/>
      </clientTarget>
   </system.web>
</configuration>

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

Обработчик раздела конфигурации

System.Web.Configuration.ClientTargetSection

Элемент конфигурации

System.Web.Configuration.ClientTarget

SystemWebSectionGroup.ClientTarget

Page.ClientTarget

Настраиваемые расположения

Machine.config

Файл Web.config корневого уровня

Файл Web.config уровня приложения

Файл Web.config уровня виртуального или физического каталога

Требования

Microsoft IIS версии 5.0, 5.1 или 6.0

.NET Framework версии 1.0, 1.1 или 2.0

Microsoft Visual Studio 2003 или Visual Studio 2005

См. также

Задачи

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

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

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

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

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

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

Ссылки

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

Элемент configuration (схема общих параметров)

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

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

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

@ Page

System.Configuration

System.Web.Configuration

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

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

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

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

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