Page.ClientTarget Eigenschaft
Definition
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.
Dient zum Abrufen oder Festlegen eines Werts, mit dem Sie die automatische Erkennung von Browserfunktionen außer Kraft setzen und angeben können, wie eine Seite für bestimmte Browserclients gerendert wird.
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
A String that specifies the browser capabilities that you want to override.
- Attribute
Beispiele
Im folgenden Codebeispiel wird ein ie302 Alias definiert und Abschnitte enthalten, die zum Konfigurieren der Anwendung in der Web.config-Datei erforderlich sind. Mit diesem Alias können Sie die ClientTarget Eigenschaft ie302 speziell für Internet Explorer 3.02-Browser auf Seiten festlegen und 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 Eigenschaft nicht festlegen, spiegelt das ClientTarget objekt, das HttpBrowserCapabilities der Page.Request Eigenschaft zugeordnet ist, die Funktionen des Clientbrowsers wider. Wenn Sie diese Eigenschaft festlegen, ist die Clientbrowsererkennung deaktiviert, und die Seite verwendet Browserfunktionen, die dem von Ihnen bereitgestellten Wert (Alias) zugeordnet sind.
Die Stammkonfigurationsdatei Web.config auf dem Webservercomputer definiert die folgenden Standardaliasen, die Sie als Abkürzung für allgemeine Benutzer-Agent-Zeichenfolgen verwenden können:
uplevel, der Browserfunktionen angibt, die Internet Explorer 6.0 entsprechen.downlevel, der Browserfunktionen angibt, die älteren Browsern entsprechen, die clientskripts nicht 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 mithilfe dieser Eigenschaft festlegen, oder Sie können ihn deklarativ mithilfe ClientTarget des Attributs der @Page-Direktive festlegen.
Sie können zusätzliche Aliase im clientTarget Abschnitt Web.config Datei auf Anwendungsebene definieren. Weitere Informationen finden Sie unter clientTarget-Element (ASP.NET Settings Schema).