AmbientAttribute Class

Definition

Gibt an, dass eine Eigenschaft oder ein Typ als Umgebung behandelt werden soll.Specifies that a property or type should be treated as ambient. Das Umgebungskonzept bezieht sich darauf, wie XAML-Prozessoren Typbesitzer von Membern bestimmen.The ambient concept relates to how XAML processors determine type owners of members.

public ref class AmbientAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Method | System.AttributeTargets.Property, Inherited=true)]
public sealed class AmbientAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Property, Inherited=true)]
public sealed class AmbientAttribute : Attribute
type AmbientAttribute = class
    inherit Attribute
Public NotInheritable Class AmbientAttribute
Inherits Attribute
Inheritance
AmbientAttribute
Attributes

Remarks

Eine Ambient-Eigenschaft ist eine Eigenschaft, bei der beim Erstellen eines Objekt Diagramms erwartet wird, dass der Wert im Parserkontext verfügbar ist, wobei jedoch die typische Typmember-Suche für Zwecke der unmittelbar erstellten XAML-Knotengruppe angehalten wird.An ambient property is a property where the value is expected to be available in the parser context when creating an object graph, but where typical type-member lookup is suspended for purposes of the immediate XAML node set being created. Für das Ambient-Konzept gibt es zwei Haupt Szenarien:There are two main scenarios for the ambient concept:

  • Eine andere Eigenschaft desselben Objekts wirkt sich darauf aus und gibt an, wie die Objekteigenschaften Suche funktionieren soll.Some other property of the same object influences and qualifies how that object-property lookup should work.

  • Die-Eigenschaft stellt einen umfassenderen Verzögerungs Mechanismus dar, und die Umgebungs Funktionen zum Suchen eines Element Werts werden auf alle Objekte im aktuellen-Objekt ausgeweitet.The property represents a larger deferral mechanism and the ambient capabilities for looking up a member value extend to all objects contained within the current object.

Dieses Attribut kann auf bestimmte Eigenschaften angewendet werden, die erwartete Container aufweisen, die ein Umgebungs Eigenschaften-Suche-Verhalten ermöglichen, oder auf eine Klasse angewendet werden, um das Ambient-Eigenschafts Verhalten in allen Fällen dieses Werttyps für eine Eigenschaft zu aktivieren.This attribute can be applied to specific properties that have expected containers that enable an ambient property lookup behavior, or can be applied to a class to enable the ambient property behavior in all cases of that value type for a property.

AmbientAttribute können auch auf eine CLR-Methode angewendet werden, um das Attributieren einer XAML-anfügbaren Eigenschaft als Ambient zu unterstützen.AmbientAttribute can also be applied to a CLR method, to support attributing a XAML attachable property as ambient. Dies ist möglicherweise erforderlich, da eine XAML-angefügte Eigenschaft in einer CLR-Implementierung implementiert/als accessormuster mit get-und set-Methoden dargestellt wird.This is potentially necessary because in a CLR implementation a XAML attached property is implemented/represented to reflection as an accessor pattern with get and set methods. Es ist keine tatsächliche CLR-Eigenschaft für das Attribut vorhanden, sodass das Einschränken der Verwendung für AttributeTargets auf Property die Angabe eines anfügbaren Members als Ambient nicht aktivieren würde.No actual CLR property to attribute exists, so restricting usage for AttributeTargets to Property would not have enabled specifying an attachable member as ambient. Für ein anfügbares Element, das Sie als Ambient melden möchten, wird der get-Accessor zugeordnet.For an attachable member that you want to report as ambient, attribute the get accessor. Sie sollten nicht versuchen, Methoden zu Attributen, die nicht explizit Methoden für anfügbare Member unterstützen.You should not attempt to attribute methods that are not specifically support methods of attachable members.

In früheren Versionen des .NET Framework war diese Klasse in der WPF-spezifischen Assembly Windows Base vorhanden.In previous versions of the .NET Framework, this class existed in the WPF-specific assembly WindowsBase. In .NET Framework 4.NET Framework 4befindet sich AmbientAttribute in der Assembly "System. XAML".In .NET Framework 4.NET Framework 4, AmbientAttribute is in the System.Xaml assembly. Weitere Informationen finden Sie unter Types Migrated from WPF to System.Xaml.For more information, see Types Migrated from WPF to System.Xaml.

Ambient-Typen (Typen, bei denen AmbientAttribute auf Typebene angewendet wird) können für bestimmte XAML-Verarbeitungs Situationen verwendet werden, in denen der Typ einer Eigenschaft nicht in der richtigen Reihenfolge aufgelöst werden muss.Ambient types (types where AmbientAttribute is applied at type level) can be used for certain XAML processing situations where the type of a property needs to be resolved out of order.

Objektwriter-SzenarienObject Writer Scenarios

Wenn Sie einen XAML-objektwriter definieren und auf eine Eigenschaft, eine Methode oder einen Typ stoßen, bei der AmbientAttribute angewendet wird, müssen Sie in der Regel auf einen Dienst zugreifen, um das gewünschte Umgebungs Eigenschaften-Suche-Verhalten zu ermitteln, das zum Schreiben von Objekten erforderlich ist.If you are defining a XAML object writer, and you encounter a property, method or type where AmbientAttribute is applied, you typically must access a service to determine the intended ambient property lookup behavior that is needed for writing out objects. Weitere Informationen finden Sie unter IAmbientProvider.For more information, see IAmbientProvider.

WertkonverterValue Converters

Typkonverter oder Markup Erweiterungen müssen möglicherweise die Umgebungs Informationen kennen, um Eigenschaften zu verarbeiten, die indirekte Typzuordnungen darstellen, wie z. b. Eigenschaften, die Member oder Typen nach Zeichen folgen Namen mit oder ohne Qualifikation angeben.Type converters or markup extensions might need to know the ambient information in order to process properties that represent indirect type mappings, such as properties that specify members or types by string names with or without qualification. In diesem Szenario ist AmbientAttribute nicht für die direkte Verwendung für die Codelogik des Wert Konverters vorgesehen.In this scenario, AmbientAttribute is not intended to be used directly for value converter code logic. Stattdessen sollte der Wert Konverter auf das Verarbeitungs Verhalten des XAML-Writers zurückgreifen, das IAmbientProvider in seinen Dienst Kontexten an Ihre Wert Konverter-Methoden übergibt, wenn er aufgerufen wird.Rather, the value converter should rely on the XAML writer processing behavior, which will pass IAmbientProvider in its service contexts to your value converter methods when called.

WPF-Szenarien für ambientattributeWPF Scenarios for AmbientAttribute

  • Eine Eigenschaft eines Style (TargetType) kann die erforderlichen Eigenschaftsnamen suchen qualifizieren, die erforderlich sind, um die Unterstützungs Verweise für Eigenschaftsnamen in Setter.Property Werten zu suchen.A property of a Style (TargetType) can qualify the necessary property name lookups that are needed to find the backing references for property names in Setter.Property values.

  • Alle Inhalte in einer Resources Eigenschaft (Elemente einer ResourceDictionary) sowie Vorlagen Inhalt sollten in der Lage sein, auf andere Peers als Werte zuzugreifen.All content within a Resources property (items of a ResourceDictionary) as well as template content, should be able to access other peers as values. Wenn Sie die gesamte Resources Eigenschaft als Ambient deklarieren, wird eine Logik aufgerufen, die dies im WPF-XAML-Parser ermöglicht.Declaring the entire Resources property as ambient invokes logic that enables this in the WPF XAML parser.

Ein Beispiel für ein Szenario für die Festlegung von AmbientAttribute auf der Typebene finden Sie unter ResourceDictionary.See ResourceDictionary for an example of a scenario for setting AmbientAttribute at type level.

Constructors

AmbientAttribute()

Initialisiert eine neue Instanz der Klasse AmbientAttribute.Initializes a new instance of the AmbientAttribute class.

Properties

TypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Methods

Equals(Object)

Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode()

Gibt den Hashcode für diese Instanz zurück.Returns the hash code for this instance.

(Inherited from Attribute)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute()

Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object)

Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explicit Interface Implementations

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Applies to

See also