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

Definizione

Ottiene o imposta un valore che consente di eseguire l'override del rilevamento automatico delle funzionalità del browser e di specificare il rendering di una pagina per client che utilizzano browser specifici.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

Valore della proprietà

Un oggetto String che specifica le funzionalità del browser che si desidera ignorare.A String that specifies the browser capabilities that you want to override.

Esempi

L'esempio di codice seguente definisce un ie302 alias e include sezioni necessari per configurare l'applicazione nel relativo file Web. config.The following code example defines an ie302 alias and includes sections needed to configure your application in its Web.config file. Usando questo alias, è possibile impostare il ClientTarget proprietà ie302 e personalizzare le pagine in modo specifico per i browser 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>  

Commenti

Se non si imposta la ClientTarget proprietà, il HttpBrowserCapabilities oggetto associato di Page.Request proprietà riflette le funzionalità del browser client.If you do not set the ClientTarget property, the HttpBrowserCapabilities object associated with the Page.Request property reflects the capabilities of the client browser. Se si imposta questa proprietà, viene disabilitato il rilevamento del browser client e la pagina userà le funzionalità del browser associate al valore (alias) specificata dall'utente.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.

Il file di configurazione Web. config radice nel computer del server Web definisce i seguenti alias predefinito che è possibile usare come sintassi abbreviata per le stringhe agente utente comuni: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, che consente di specificare le funzionalità del browser equivalente a Internet Explorer 6.0.uplevel, which specifies browser capabilities equivalent to Internet Explorer 6.0.

  • downlevel, che consente di specificare le funzionalità del browser equivalente al browser meno recenti che non supportano lo script client.downlevel, which specifies browser capabilities equivalent to older browsers that do not support client script. È possibile usare questo alias per determinare come funzionerebbero le pagine Web in un browser che dispone di script client disabilitato.You can use this alias to determine how Web pages would work in a browser that has client script disabled.

È possibile impostare l'alias a livello di programmazione usando questa proprietà, oppure è possibile impostare in modo dichiarativo utilizzando il ClientTarget attributo della direttiva.You can set the alias programmatically using this property, or you can set it declaratively using the ClientTarget attribute of the directive.

È possibile definire gli alias aggiuntivi nel clientTarget sezione del file Web. config a livello di applicazione.You can define additional aliases in the clientTarget section of the application-level Web.config file. Per altre informazioni, vedere clientTarget (Schema delle impostazioni ASP.NET) elemento.For more information, see clientTarget Element (ASP.NET Settings Schema).

Si applica a

Vedi anche