Page.ClientTarget Propriedade

Referência

Definição

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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 de Web.config. Usando esse alias, você pode definir a ClientTarget propriedade para ie302 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á os recursos do navegador associados ao valor (alias) fornecido.

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 do usuário:

uplevel, que especifica os 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 com 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 clientTarget seção do arquivo de Web.config no nível do aplicativo. Para obter mais informações, consulte o elemento clientTarget (esquema ASP.NET Configurações).

Aplica-se a