ClientTarget Klasse

Referenz

Definition

Namespace:: System.Web.Configuration

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.

Definiert den Alias, der dem Ziel-Benutzer-Agent zugeordnet ist, für den ASP.NET-Serversteuerelemente Inhalt rendern müssen. Diese Klasse kann nicht vererbt werden.

public ref class ClientTarget sealed : System::Configuration::ConfigurationElement

public sealed class ClientTarget : System.Configuration.ConfigurationElement

type ClientTarget = class
    inherit ConfigurationElement

Public NotInheritable Class ClientTarget
Inherits ConfigurationElement

Vererbung: Object

ConfigurationElement
ClientTarget

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Die erste veranschaulicht, wie Werte für mehrere Eigenschaften der ClientTarget -Klasse deklarativ angegeben werden. Die zweite zeigt, wie Das ClientTargetCollection Objekt aus der Konfigurationsdatei abgerufen wird. Sie verwenden dieses Objekt, um auf die ClientTarget enthaltenen Objekte zuzugreifen.

Das folgende Codebeispiel zeigt, wie Werte für mehrere Eigenschaften der ClientTarget -Klasse deklarativ angegeben werden.

<clientTarget>
  <add alias=
    "uplevel"
    userAgent="Mozilla/5.0 (compatible;MSIE 6.0;Windows NT 5.1)"/>
  <add alias="downlevel" userAgent="Generic Downlevel"/>
</clientTarget>

Im folgenden Codebeispiel wird veranschaulicht, wie Das ClientTargetCollection Objekt aus der Konfigurationsdatei abgerufen wird.


// Get the Web application configuration.
System.Configuration.Configuration configuration =
    WebConfigurationManager.OpenWebConfiguration(
    "/aspnetTest");

// Get the <clientTarget> section.
ClientTargetSection clientTargetSection =
  (ClientTargetSection)configuration.GetSection(
  "system.web/clientTarget");


// Get the client target collection.
ClientTargetCollection clientTargets =
  clientTargetSection.ClientTargets;

' Get the Web application configuration.
Dim configuration _
As System.Configuration.Configuration = _
WebConfigurationManager.OpenWebConfiguration( _
"/aspnetTest")

' Get the <clientTarget> section.
Dim clientTargetSection _
As ClientTargetSection = _
CType(configuration.GetSection( _
"system.web/clientTarget"), _
ClientTargetSection)

' Get the client target collection.
Dim clientTargets _
As ClientTargetCollection = _
clientTargetSection.ClientTargets

Hinweise

Die ClientTarget -Klasse bezieht sich auf Elemente, die clientTarget im Abschnitt der Konfigurationsdatei hinzugefügt werden.

Die ClientTarget Klasse gehört zu einer Gruppe, die die ClientTargetCollection -Klasse und die ClientTargetSection -Klasse enthält.

Die ClientTarget -Klasse enthält zwei Eigenschaften, die einen Clientbrowser identifizieren, auch als Benutzer-Agent bezeichnet. Eine Eigenschaft ist der Alias, der dem durch die zweite Eigenschaft identifizierten Clientbrowser zugeordnet ist. ASP.NET verwendet diese Informationen, um Serversteuerelemente auf einer Seite zu rendern.

Informationen dazu, wie der Benutzer-Agent oder sein Alias programmgesteuert verwendet wird, finden Sie in der Page.ClientTarget -Eigenschaft. Informationen dazu, wie der Benutzer-Agent oder sein Alias deklarativ verwendet wird, finden Sie unter @ Page.

Wenn die Page.ClientTarget Eigenschaft nicht festgelegt ist, spiegelt das HttpBrowserCapabilities Objekt, das der Page.Request -Eigenschaft zugeordnet ist, die Funktionen des Clientbrowsers wider. (Es spiegelt die Funktionen des Browsertyps wider, aber nicht unbedingt die Einstellungen in einer bestimmten Instanz dieses Browsers.) Wenn die -Eigenschaft festgelegt ist, ist die Clientbrowsererkennung deaktiviert, und die Seite verwendet Browserfunktionen, die der von Ihnen definierten Benutzer-Agent-Zeichenfolge zugeordnet sind. Sie können diese Eigenschaft auf eine beliebige gültige Benutzer-Agent-Zeichenfolge festlegen.

Konstruktoren

ClientTarget(String, String)

Initialisiert eine neue Instanz der ClientTarget-Klasse.

Eigenschaften

Alias	Ruft den Alias des Benutzer-Agents ab.
CurrentConfiguration	Ruft einen Verweis auf die Configuration-Instanz der obersten Ebene ab, die die Konfigurationshierarchie darstellt, zu der die aktuelle ConfigurationElement-Instanz gehört. (Geerbt von ConfigurationElement)
ElementInformation	Ruft ein ElementInformation-Objekt ab, das die nicht anpassbaren Informationen und Funktionen des ConfigurationElement-Objekts enthält. (Geerbt von ConfigurationElement)
ElementProperty	Ruft das ConfigurationElementProperty-Objekt ab, das das ConfigurationElement-Objekt selbst darstellt. (Geerbt von ConfigurationElement)
EvaluationContext	Ruft das ContextInformation-Objekt für das ConfigurationElement-Objekt ab. (Geerbt von ConfigurationElement)
HasContext	Ruft einen Wert ab, der angibt, ob die CurrentConfiguration-Eigenschaft `null` ist. (Geerbt von ConfigurationElement)
Item[ConfigurationProperty]	Ruft eine Eigenschaft oder ein Attribut dieses Konfigurationselements ab oder legt diese bzw. dieses fest. (Geerbt von ConfigurationElement)
Item[String]	Ruft eine Eigenschaft, ein Attribut oder ein untergeordnetes Element dieses Konfigurationselements ab oder legt diese(s) fest. (Geerbt von ConfigurationElement)
LockAllAttributesExcept	Ruft die Auflistung gesperrter Attribute ab. (Geerbt von ConfigurationElement)
LockAllElementsExcept	Ruft die Auflistung gesperrter Elemente ab. (Geerbt von ConfigurationElement)
LockAttributes	Ruft die Auflistung gesperrter Attribute ab. (Geerbt von ConfigurationElement)
LockElements	Ruft die Auflistung gesperrter Elemente ab. (Geerbt von ConfigurationElement)
LockItem	Ruft einen Wert ab, der angibt, ob das Element gesperrt ist, oder legt diesen fest. (Geerbt von ConfigurationElement)
Properties	Ruft die Auflistung von Eigenschaften ab. (Geerbt von ConfigurationElement)
UserAgent	Ruft den Identifikationsnamen des Benutzer-Agents ab.

Methoden

DeserializeElement(XmlReader, Boolean)	Liest XML aus der Konfigurationsdatei. (Geerbt von ConfigurationElement)
Equals(Object)	Vergleicht die aktuelle ConfigurationElement-Instanz mit dem angegebenen Objekt. (Geerbt von ConfigurationElement)
GetHashCode()	Ruft einen eindeutigen Wert ab, der die aktuelle ConfigurationElement-Instanz darstellt. (Geerbt von ConfigurationElement)
GetTransformedAssemblyString(String)	Gibt die transformierte Version des angegebenen Assemblynamens zurück. (Geerbt von ConfigurationElement)
GetTransformedTypeString(String)	Gibt die transformierte Version des angegebenen Typnamens zurück. (Geerbt von ConfigurationElement)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Init()	Legt für das ConfigurationElement-Objekt den Ausgangszustand fest. (Geerbt von ConfigurationElement)
InitializeDefault()	Wird verwendet, um einen Standardsatz von Werten für das ConfigurationElement-Objekt zu initialisieren. (Geerbt von ConfigurationElement)
IsModified()	Gibt an, ob dieses Konfigurationselement geändert wurde, seit es zuletzt gespeichert oder geladen wurde, wenn es in einer abgeleiteten Klasse implementiert wurde. (Geerbt von ConfigurationElement)
IsReadOnly()	Ruft einen Wert ab, der angibt, ob das ConfigurationElement schreibgeschützt ist. (Geerbt von ConfigurationElement)
ListErrors(IList)	Fügt die Fehler über ungültige Eigenschaften in diesem ConfigurationElement-Objekt und in allen Unterelementen der übergebenen Liste hinzu. (Geerbt von ConfigurationElement)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnDeserializeUnrecognizedAttribute(String, String)	Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Attribut aufgetreten ist. (Geerbt von ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Element aufgetreten ist. (Geerbt von ConfigurationElement)
OnRequiredPropertyNotFound(String)	Löst eine Ausnahme aus, wenn eine erforderliche Eigenschaft nicht gefunden wird. (Geerbt von ConfigurationElement)
PostDeserialize()	Wird nach der Deserialisierung aufgerufen. (Geerbt von ConfigurationElement)
PreSerialize(XmlWriter)	Wird vor der Serialisierung aufgerufen. (Geerbt von ConfigurationElement)
Reset(ConfigurationElement)	Setzt den internen Status dieses ConfigurationElement-Objekts zurück, einschließlich der Sperren und der Eigenschaftenauflistungen. (Geerbt von ConfigurationElement)
ResetModified()	Setzt bei Implementierung in einer abgeleiteten Klasse den Wert der IsModified()-Methode auf `false` zurück. (Geerbt von ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Schreibt bei Implementierung in einer abgeleiteten Klasse den Inhalt dieses Konfigurationselements in die Konfigurationsdatei. (Geerbt von ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Schreibt bei Implementierung in einer abgeleiteten Klasse die äußeren Tags dieses Konfigurationselements in die Konfigurationsdatei. (Geerbt von ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Legt eine Eigenschaft auf den angegebenen Wert fest. (Geerbt von ConfigurationElement)
SetReadOnly()	Legt die IsReadOnly()-Eigenschaft für das ConfigurationElement-Objekt und alle Unterelemente fest. (Geerbt von ConfigurationElement)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Ändert das ConfigurationElement-Objekt, um alle Werte zu entfernen, die nicht gespeichert werden sollen. (Geerbt von ConfigurationElement)

Gilt für: