Page.ClientTarget Свойство

Определение

Возвращает или задает значение, позволяющее переопределить автоматическое обнаружение характеристик браузера и задать способ отображения страницы для конкретного браузера клиента.Gets or sets a value that allows you to override automatic detection of browser capabilities and to specify how a page is rendered for particular browser clients.

public:
 property System::String ^ ClientTarget { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Browsable(false)]
public string ClientTarget { get; set; }
member this.ClientTarget : string with get, set
Public Property ClientTarget As String

Значение свойства

Значение String, задающее переопределяемые характеристики браузера.A String that specifies the browser capabilities that you want to override.

Атрибуты

Примеры

В следующем примере кода определяется псевдоним ie302 и содержатся разделы, необходимые для настройки приложения в своем файле Web. config.The following code example defines an ie302 alias and includes sections needed to configure your application in its Web.config file. С помощью этого псевдонима можно задать для свойства ClientTarget значение ie302 и настроить страницы специально для браузеров Internet Explorer 3,02.Using this alias, you can set the ClientTarget property to ie302 and customize pages specifically for Internet Explorer 3.02 browsers.

<configuration>  
  <system.web>  
   <clientTarget>  
    <add alias="ie302" useragent="Mozilla/2.0 (compatible; MSIE 3.02; Windows NT 3.5)" />  
   </clientTarget>  
  </system.web>  
</configuration>  

Комментарии

Если не задать свойство ClientTarget, HttpBrowserCapabilities объект, связанный со свойством Page.Request, отражает возможности клиентского браузера.If you do not set the ClientTarget property, the HttpBrowserCapabilities object associated with the Page.Request property reflects the capabilities of the client browser. Если задать это свойство, обнаружение клиентских браузеров будет отключено, а на странице будут использоваться возможности браузера, связанные со значением (псевдонимом), которое вы задаете.If you do set this property, client browser detection is disabled and the page will use browser capabilities associated with the value (alias) that you provide.

Корневой файл конфигурации Web. config на компьютере веб-сервера определяет следующие псевдонимы по умолчанию, которые можно использовать в качестве краткой формы для общих строк агента пользователя:The root Web.config configuration file on the Web server computer defines the following default aliases that you can use as shorthand for common user-agent strings:

  • uplevel, определяющие возможности браузера, эквивалентные Internet Explorer 6,0.uplevel, which specifies browser capabilities equivalent to Internet Explorer 6.0.

  • downlevel, который указывает возможности браузера, эквивалентные старым браузерам, которые не поддерживают клиентский скрипт.downlevel, which specifies browser capabilities equivalent to older browsers that do not support client script. С помощью этого псевдонима можно определить, как веб-страницы будут работать в браузере с отключенным клиентским сценарием.You can use this alias to determine how Web pages would work in a browser that has client script disabled.

Псевдоним можно задать программным способом с помощью этого свойства или декларативно с помощью атрибута ClientTarget директивы @ Page .You can set the alias programmatically using this property, or you can set it declaratively using the ClientTarget attribute of the @ Page directive.

Можно определить дополнительные псевдонимы в разделе clientTarget файла Web. config уровня приложения.You can define additional aliases in the clientTarget section of the application-level Web.config file. Дополнительные сведения см. в разделе элемент ClientTarget (схема параметров ASP.NET).For more information, see clientTarget Element (ASP.NET Settings Schema).

Применяется к

Дополнительно