Page.ClientTarget Page.ClientTarget Page.ClientTarget Page.ClientTarget Property

Definición

Obtiene o establece un valor que permite reemplazar la detección automática de las funciones del explorador y especificar cómo se representa una página para clientes de explorador concretos.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

Valor de propiedad

String que especifica las funciones de explorador que se desean reemplazar.A String that specifies the browser capabilities that you want to override.

Ejemplos

En el ejemplo de código siguiente ie302 se define un alias e incluye las secciones necesarias para configurar la aplicación en su archivo Web. config.The following code example defines an ie302 alias and includes sections needed to configure your application in its Web.config file. Con este alias, puede establecer la ClientTarget propiedad en ie302 y personalizar las páginas específicamente para los exploradores de 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>  

Comentarios

Si no se establece la ClientTarget propiedad, el HttpBrowserCapabilities objeto asociado a la Page.Request propiedad refleja las funciones del explorador del cliente.If you do not set the ClientTarget property, the HttpBrowserCapabilities object associated with the Page.Request property reflects the capabilities of the client browser. Si establece esta propiedad, la detección del explorador del cliente está deshabilitada y la página utilizará las funciones del explorador asociadas con el valor (alias) que proporcione.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.

El archivo de configuración raíz de Web. config en el equipo del servidor Web define los siguientes alias predeterminados que puede usar como abreviatura para las cadenas de agente de usuario comunes: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, que especifica las capacidades del explorador equivalentes a Internet Explorer 6,0.uplevel, which specifies browser capabilities equivalent to Internet Explorer 6.0.

  • downlevel, que especifica las funciones del explorador equivalentes a los exploradores más antiguos que no admiten el script de cliente.downlevel, which specifies browser capabilities equivalent to older browsers that do not support client script. Puede usar este alias para determinar el funcionamiento de las páginas web en un explorador que tenga deshabilitado el script de cliente.You can use this alias to determine how Web pages would work in a browser that has client script disabled.

Puede establecer el alias mediante programación con esta propiedad o puede establecerlo mediante declaración con el ClientTarget atributo de la directiva @ Page .You can set the alias programmatically using this property, or you can set it declaratively using the ClientTarget attribute of the @ Page directive.

Puede definir alias adicionales en la clientTarget sección del archivo Web. config de nivel de aplicación.You can define additional aliases in the clientTarget section of the application-level Web.config file. Para obtener más información, consulte elemento ClientTarget (esquema de configuración de ASP.net).For more information, see clientTarget Element (ASP.NET Settings Schema).

Se aplica a

Consulte también: