Freigeben über

clientTarget-Element (ASP.NET-Einstellungsschema)

  • Artikel

Aktualisiert: November 2007

Fügt einer internen Auflistung von Aliasen für Benutzeragenten Aliase für bestimmte Benutzeragenten hinzu.

<configuration>-Element
  system.web-Element (ASP.NET-Einstellungsschema)
    clientTarget-Element (ASP.NET-Einstellungsschema)

<clientTarget> 
   <add... />
   <remove... />
   <clear/>
</clientTarget>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente sowie übergeordnete Elemente beschrieben.

Attribute

Keine

Untergeordnete Elemente

Element

Beschreibung

add

Optionales Element

Fügt einer internen Auflistung mit Aliasen für Benutzeragenten einen Alias für einen bestimmten Benutzeragenten hinzu.

clear

Optionales Element

Entfernt alle Aliase, die derzeit in der angegebenen Datei Web.config enthalten sind oder von ihr geerbt wurden.

remove

Optionales Element

Entfernt aus einer internen Auflistung von Aliasen für Benutzeragenten einen Alias für einen bestimmten Benutzeragenten. Der Wert muss genau mit dem einer vorherigen add-Direktive übereinstimmen. Platzhalterzeichen werden nicht unterstützt.

Übergeordnete Elemente

Element

Beschreibung

configuration

Gibt das erforderliche Stammelement in jeder Konfigurationsdatei an, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.

system.web

Gibt das Stammelement für den ASP.NET-Konfigurationsabschnitt an.

Hinweise

Die Auflistung der Aliase für Benutzeragenten gibt die Zielbenutzeragenten an, für die ASP.NET-Serversteuerelemente Inhalt ausgeben sollen.

Standardkonfiguration

Das folgende clientTarget-Standardelement wird in der Stammdatei Web.config in .NET Framework, Version 2.0, konfiguriert.

<clientTarget>
     <add alias="ie5" userAgent="Mozilla/4.0 (compatible; MSIE 5.5; Windows NT 4.0" />
     <add alias="ie4" userAgent="Mozilla/4.0 (compatible; MSIE 4.0; Windows NT 4.0" />
     <add alias="uplevel" userAgent="Mozilla/4.0 (compatible; MSIE 5.5; Windows NT 5.1)" />
     <add alias="downlevel" userAgent="Generic Downlevel" />
</clientTarget>

Das folgende clientTarget-Standardelement wird in der Datei Machine.config in .NET Framework, Version  1.0 und 1.1, konfiguriert.

<clientTarget>
     <add alias="ie5" userAgent="Mozilla/4.0 (compatible; MSIE 5.5; Windows NT 4.0)"/>
     <add alias="ie4" userAgent="Mozilla/4.0 (compatible; MSIE 4.0; Windows NT 4.0)"/>
     <add alias="uplevel" userAgent="Mozilla/4.0 (compatible; MSIE 4.0; Windows NT 4.0)"/>
     <add alias="downlevel" userAgent="Unknown"/>
</clientTarget>

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie Sie vier Aliase für Benutzeragenten hinzufügen.

<configuration>
   <system.web>
      <clientTarget>
         <add alias="ie5" userAgent="Mozilla/4.0 (compatible;MSIE 5.5;Windows NT 4.0)"/>
         <add alias="ie4" userAgent="Mozilla/4.0 (compatible;MSIE 4.0;Windows NT 4.0)"/>
         <add alias="uplevel" userAgent="Mozilla/4.0 (compatible;MSIE 4.0;Windows NT 4.0)"/>
         <add alias="downlevel" userAgent="Unknown"/>
      </clientTarget>
   </system.web>
</configuration>

Elementinformationen

Konfigurationsabschnittshandler

System.Web.Configuration.ClientTargetSection

Konfigurationsmember

System.Web.Configuration.ClientTarget

SystemWebSectionGroup.ClientTarget

Page.ClientTarget

Konfigurierbare Speicherorte

Machine.config

Web.config auf der Stammebene

Web.config auf der Anwendungsebene

Web.config auf der Ebene virtueller oder physikalischer Verzeichnisse

Anforderungen

Microsoft Internetinformationsdienste (IIS), Version 5.0, 5.1 oder 6.0

.NET Framework, Version 1.0, 1.1 oder 2.0

Microsoft Visual Studio 2003 oder Visual Studio 2005

Siehe auch

Aufgaben

Gewusst wie: Sperren von ASP.NET-Konfigurationseinstellungen

Konzepte

Übersicht über die ASP.NET-Konfiguration

ASP.NET-Webserversteuerelemente und Browserfunktionen

Absichern der ASP.NET-Konfiguration

ASP.NET-Konfigurationsszenarios

Referenz

system.web-Element (ASP.NET-Einstellungsschema)

configuration-Element (allgemeines Einstellungsschema)

add-Element für clientTarget (ASP.NET-Einstellungsschema)

clear-Element für clientTarget (ASP.NET-Einstellungsschema)

remove-Element für clientTarget (ASP.NET-Einstellungsschema)

@ Page

System.Configuration

System.Web.Configuration

Weitere Ressourcen

ASP.NET-Konfigurationsdateien

ASP.NET-Konfigurationseinstellungen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurations-API