Page.ClientTarget Proprietà
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; }
[<System.ComponentModel.Browsable(false)>]
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.
- Attributi
Esempio
Nell'esempio di codice seguente viene definito un ie302
alias e sono incluse le sezioni necessarie per configurare l'applicazione nel file di Web.config.The following code example defines an ie302
alias and includes sections needed to configure your application in its Web.config file. Utilizzando questo alias, è possibile impostare la ClientTarget proprietà su 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à, l' HttpBrowserCapabilities oggetto associato alla 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à, il rilevamento del browser client viene disabilitato e la pagina utilizzerà le funzionalità del browser associate al valore (alias) fornito.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 server Web definisce gli alias predefiniti seguenti che è possibile utilizzare come abbreviazione per le stringhe utente-agente 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 specifica le funzionalità del browser equivalenti a Internet Explorer 6,0.uplevel
, which specifies browser capabilities equivalent to Internet Explorer 6.0.downlevel
, che specifica le funzionalità del browser equivalenti ai 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 utilizzare questo alias per determinare il funzionamento delle pagine Web in un browser con lo 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 codice utilizzando questa proprietà oppure è possibile impostarlo in modo dichiarativo utilizzando l' ClientTarget
attributo della direttiva @ Page .You can set the alias programmatically using this property, or you can set it declaratively using the ClientTarget
attribute of the @ Page directive.
È possibile definire alias aggiuntivi nella clientTarget
sezione del file di Web.config a livello di applicazione.You can define additional aliases in the clientTarget
section of the application-level Web.config file. Per ulteriori informazioni, vedere elemento clientTarget (schema delle impostazioni ASP.NET).For more information, see clientTarget Element (ASP.NET Settings Schema).