Page.ClientTarget Propriedade

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Obtém ou define um valor que permite que você substitua a detecção automática dos recursos do navegador e especifique como uma página é processada para determinados clientes de navegador.

public:
 property System::String ^ ClientTarget { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Browsable(false)]
public string ClientTarget { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.ClientTarget : string with get, set

Public Property ClientTarget As String

Valor da propriedade

String

Um String que especifica os recursos do navegador que você deseja substituir.

Atributos

BrowsableAttribute

Exemplos

O exemplo de código a seguir define um ie302 alias e inclui seções necessárias para configurar seu aplicativo em seu arquivo Web.config. Usando esse alias, você pode definir a ClientTarget propriedade como ie302 e personalizar páginas especificamente para navegadores do Internet Explorer 3.02.

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

Comentários

Se você não definir a ClientTarget propriedade, o HttpBrowserCapabilities objeto associado Page.Request à propriedade refletirá os recursos do navegador cliente. Se você definir essa propriedade, a detecção do navegador do cliente será desabilitada e a página usará recursos do navegador associados ao valor (alias) que você fornecer.

O arquivo de configuração de Web.config raiz no computador do servidor Web define os seguintes aliases padrão que você pode usar como abreviação para cadeias de caracteres comuns do agente de usuário:

• uplevel, que especifica recursos do navegador equivalentes ao Internet Explorer 6.0.

• downlevel, que especifica recursos do navegador equivalentes a navegadores mais antigos que não dão suporte ao script do cliente. Você pode usar esse alias para determinar como as páginas da Web funcionariam em um navegador que tem o script do cliente desabilitado.

Você pode definir o alias programaticamente usando essa propriedade ou defini-lo declarativamente usando o ClientTarget atributo da diretiva @ Page .

Você pode definir aliases adicionais na seção do arquivo de Web.config no clientTarget nível do aplicativo. Para obter mais informações, consulte Elemento clientTarget (ASP.NET Esquema de Configurações).

Confira também

• HttpBrowserCapabilities
• Browser
• UserAgent
• ASP.NET controles de servidor e recursos do navegador
• Arquivos de configuração do ASP.NET