Page.ClientTarget Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Wert ab, der es Ihnen ermöglicht, die automatische Erkennung von Browserfunktionen zu überschreiben und die Art des Renderns einer Seite für bestimmte Browserclients anzugeben, oder legt diesen fest.

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

Eigenschaftswert

String

Ein String, der die Browserfunktionen angibt, die überschrieben werden sollen.

Attribute: BrowsableAttribute

Beispiele

Das folgende Codebeispiel definiert einen ie302 Alias und enthält Abschnitte, die zum Konfigurieren Ihrer Anwendung in der Web.config-Datei erforderlich sind. Mit diesem Alias können Sie die ClientTarget -Eigenschaft auf ie302 festlegen und Seiten speziell für Internet Explorer 3.02-Browser anpassen.

<configuration>  
  <system.web>  
   <clientTarget>  
    <add alias="ie302" useragent="Mozilla/2.0 (compatible; MSIE 3.02; Windows NT 3.5)" />  
   </clientTarget>  
  </system.web>  
</configuration>

Hinweise

Wenn Sie die ClientTarget -Eigenschaft nicht festlegen, spiegelt das HttpBrowserCapabilities der Page.Request -Eigenschaft zugeordnete Objekt die Funktionen des Clientbrowsers wider. Wenn Sie diese Eigenschaft festlegen, ist die Clientbrowsererkennung deaktiviert, und die Seite verwendet Browserfunktionen, die dem von Ihnen angegebenen Wert (Alias) zugeordnet sind.

Die Stammkonfigurationsdatei Web.config auf dem Webservercomputer definiert die folgenden Standardaliasen, die Sie als Kurzform für allgemeine Benutzer-Agent-Zeichenfolgen verwenden können:

uplevel, das Browserfunktionen angibt, die Internet Explorer 6.0 entsprechen.
downlevel, die Browserfunktionen angibt, die älteren Browsern entsprechen, die kein Clientskript unterstützen. Sie können diesen Alias verwenden, um zu bestimmen, wie Webseiten in einem Browser funktionieren würden, in dem das Clientskript deaktiviert ist.

Sie können den Alias programmgesteuert mit dieser Eigenschaft festlegen, oder Sie können ihn deklarativ mithilfe des ClientTarget Attributs der @Page-Direktive festlegen.

Sie können zusätzliche Aliase im Abschnitt der clientTarget Web.config-Datei auf Anwendungsebene definieren. Weitere Informationen finden Sie unter clientTarget-Element (ASP.NET Einstellungsschema).

Gilt für:

Freigeben über