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

Definition

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.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

Eigenschaftswert

Ein String, der die Browserfunktionen angibt, die überschrieben werden sollen.A String that specifies the browser capabilities that you want to override.

Beispiele

Das folgende Codebeispiel definiert einen ie302 Alias und enthält Abschnitte, die zum Konfigurieren der Anwendung in der Datei "Web. config" erforderlich sind.The following code example defines an ie302 alias and includes sections needed to configure your application in its Web.config file. Mit diesem Alias können Sie die ClientTarget -Eigenschaft auf ie302 festlegen und Seiten speziell für Internet Explorer 3,02-Browser anpassen.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>  

Hinweise

Wenn Sie die ClientTarget -Eigenschaft nicht festlegen, reflektiert HttpBrowserCapabilities das-Objekt, Page.Request das der-Eigenschaft zugeordnet ist, die Funktionen des Client Browsers.If you do not set the ClientTarget property, the HttpBrowserCapabilities object associated with the Page.Request property reflects the capabilities of the client browser. Wenn Sie diese Eigenschaft festlegen, wird die Client Browser Erkennung deaktiviert, und die Seite verwendet Browserfunktionen, die mit dem von Ihnen bereitgestellten Wert (Alias) verknüpft sind.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.

Die Konfigurationsdatei root Web. config auf dem Webserver Computer definiert die folgenden Standard Aliase, die Sie als Kurzform für gängige Benutzeragentzeichenfolgen verwenden können: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, das Browserfunktionen angibt, die Internet Explorer 6,0 entsprechen.uplevel, which specifies browser capabilities equivalent to Internet Explorer 6.0.

  • downlevel, das Browserfunktionen angibt, die älteren Browsern entsprechen, die keine Client Skripts unterstützen.downlevel, which specifies browser capabilities equivalent to older browsers that do not support client script. Sie können diesen Alias verwenden, um zu bestimmen, wie Webseiten in einem Browser funktionieren, für den das Client Skript deaktiviert ist.You can use this alias to determine how Web pages would work in a browser that has client script disabled.

Der Alias kann mithilfe dieser Eigenschaft Programm gesteuert festgelegt werden, oder Sie können ihn deklarativ mithilfe des ClientTarget -Attributs der @ Page -Direktive festlegen.You can set the alias programmatically using this property, or you can set it declaratively using the ClientTarget attribute of the @ Page directive.

Im clientTarget Abschnitt der Datei "Web. config" auf Anwendungsebene können Sie weitere Aliase definieren.You can define additional aliases in the clientTarget section of the application-level Web.config file. Weitere Informationen finden Sie unter clientTarget-Element (ASP.NET Settings Schema).For more information, see clientTarget Element (ASP.NET Settings Schema).

Gilt für:

Siehe auch