ClientTarget Classe

Definição

public ref class ClientTarget sealed : System::Configuration::ConfigurationElement

public sealed class ClientTarget : System.Configuration.ConfigurationElement

type ClientTarget = class
    inherit ConfigurationElement

Public NotInheritable Class ClientTarget
Inherits ConfigurationElement

Herança

Object

ConfigurationElement

ClientTarget

Exemplos

Esta secção fornece dois exemplos de código. A primeira demonstra como especificar declarativamente valores para várias propriedades da ClientTarget classe. A segunda mostra como obter o ClientTargetCollection objeto a partir do ficheiro de configuração. Usas este objeto para aceder aos ClientTarget objetos que contém.

O exemplo de código seguinte mostra como especificar declarativamente valores para várias propriedades da ClientTarget classe.

<clientTarget>
  <add alias=
    "uplevel"
    userAgent="Mozilla/5.0 (compatible;MSIE 6.0;Windows NT 5.1)"/>
  <add alias="downlevel" userAgent="Generic Downlevel"/>
</clientTarget>

O seguinte exemplo de código mostra como obter o ClientTargetCollection objeto a partir do ficheiro de configuração.

// Get the Web application configuration.
System.Configuration.Configuration configuration =
    WebConfigurationManager.OpenWebConfiguration(
    "/aspnetTest");

// Get the <clientTarget> section.
ClientTargetSection clientTargetSection =
  (ClientTargetSection)configuration.GetSection(
  "system.web/clientTarget");


// Get the client target collection.
ClientTargetCollection clientTargets =
  clientTargetSection.ClientTargets;

' Get the Web application configuration.
Dim configuration _
As System.Configuration.Configuration = _
WebConfigurationManager.OpenWebConfiguration( _
"/aspnetTest")

' Get the <clientTarget> section.
Dim clientTargetSection _
As ClientTargetSection = _
CType(configuration.GetSection( _
"system.web/clientTarget"), _
ClientTargetSection)

' Get the client target collection.
Dim clientTargets _
As ClientTargetCollection = _
clientTargetSection.ClientTargets

Observações

A ClientTarget classe refere-se a elementos que são adicionados na clientTarget secção do ficheiro de configuração.

A ClientTarget classe pertence a um grupo que inclui a ClientTargetCollection classe e a classe ClientTargetSection .

A ClientTarget classe contém duas propriedades que identificam um navegador cliente, também denominadas user agent. Uma propriedade é o alias associado ao navegador cliente identificado pela segunda propriedade. O ASP.NET utiliza esta informação para renderizar os controlos do servidor numa página.

Para informações sobre como o user agent ou o seu alias é usado programaticamente, consulte a Page.ClientTarget propriedade. Para informações sobre como o user agent ou o seu alias é usado declarativamente, veja @ Page.

Se a Page.ClientTarget propriedade não estiver definida, o HttpBrowserCapabilities objeto associado à Page.Request propriedade reflete as capacidades do navegador cliente. (Reflete as capacidades do tipo de navegador, mas não necessariamente as definições numa instância específica desse navegador.) Se a propriedade estiver definida, a deteção do navegador do cliente fica desativada e a página utiliza funcionalidades do navegador associadas à string de agente de utilizador que definiste. Pode definir esta propriedade para qualquer string de agente de utilizador válida.

Ver também

• ClientTargetSection
• ClientTargetCollection
• ClientTarget
• ASP.NET Controlos do Servidor e Capacidades do Navegador