Page.ClientTarget Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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.

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à

String

Un oggetto String che specifica le funzionalità del browser che si desidera ignorare.

Attributi: BrowsableAttribute

Esempio

L'esempio di codice seguente definisce un ie302 alias e include sezioni necessarie per configurare l'applicazione nel relativo file Web.config. Utilizzando questo alias, è possibile impostare la ClientTarget proprietà su ie302 e personalizzare le pagine specificamente per i browser 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>

Commenti

Se non si imposta la ClientTarget proprietà , l'oggetto HttpBrowserCapabilities associato Page.Request alla proprietà riflette le funzionalità del browser client. Se si imposta questa proprietà, il rilevamento del browser client è disabilitato e la pagina userà le funzionalità del browser associate al valore (alias) specificato.

Il file di configurazione radice Web.config nel computer server Web definisce gli alias predefiniti seguenti che è possibile usare come abbreviato per le stringhe comuni dell'agente utente:

uplevel, che specifica le funzionalità del browser equivalenti a Internet Explorer 6.0.
downlevel, che specifica le funzionalità del browser equivalenti ai browser meno recenti che non supportano lo script client. È possibile usare questo alias per determinare il funzionamento delle pagine Web in un browser con script client disabilitato.

È possibile impostare l'alias a livello di codice usando questa proprietà oppure impostarlo in modo dichiarativo usando l'attributo ClientTarget della direttiva @ Page .

È possibile definire alias aggiuntivi nella clientTarget sezione del file di Web.config a livello di applicazione. Per altre informazioni, vedere Elemento clientTarget (schema ASP.NET Impostazioni).For more information, see clientTarget Element (ASP.NET Impostazioni Schema).

Si applica a