AmbientPropertyValue Klasse
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.
Meldet Informationen zu einer Ambient-Eigenschaft als Teil einer IAmbientProvider-Implementierung.
public ref class AmbientPropertyValue
public class AmbientPropertyValue
type AmbientPropertyValue = class
Public Class AmbientPropertyValue
- Vererbung
-
AmbientPropertyValue
Hinweise
AmbientPropertyValue stellt ein Informationselement dar, das durch Aufrufen einer IAmbientProvider Dienstmethode zurückgegeben wird. Die GetAll
Methoden geben Enumerationen oder Arrays von AmbientPropertyValue Elementen zurück; die GetFirst
Methoden geben eine einzelne AmbientPropertyValuezurück.
Informationen zu Umgebungseigenschaften
Eine Umgebungseigenschaft ist eine Eigenschaft, deren Eigenschaftswert für die Verwendung des Wertkonverters in der XAML-Knotenstruktur und für das Objektdiagramm darunter verfügbar sein soll. Das Umgebungskonzept ist für einen XAML-Prozessor während der Objektschreibphase des Ladepfads oder der Serialisierungsphase eines Speicherpfads relevant.
Ein Typ kann auch als Umgebung zugeordnet werden. In diesem Fall werden alle Eigenschaften, die den attributten Typ verwenden, als Umgebung gemeldet.
Im Lastenpfad-Fall kann der Umgebungseigenschaftswert den wert des Objektdiagramms beeinflussen, das einen Wert anderer Eigenschaften erzeugt hat, die darunter in einer XAML-Knotenstruktur vorhanden sind. Bei der Verarbeitung als XAML-Knotendatenstrom bedeutet das Umgebungskonzept, dass der Umgebungseigenschaftswert für Typkonverter und Markuperweiterungen von StartObject
auf EndObject
verfügbar sein muss. Ebenso kann ein Typkonverter oder eine Markuperweiterung, die für den Speicherpfad verwendet wird, die Umgebungseigenschaft und seinen Wert nachschlagen. Daher ist der xaml-Code, der erstellt wird, eine bessere Roundtripdarstellung.
Mit der Sprachdefinition gibt XAML nicht die Reihenfolge an, in der Elemente eines Objekts verarbeitet werden müssen. Jeder Umgebungseigenschaftswert muss jedoch zuerst vom XAML-Reader verarbeitet werden, damit der Typkonverter und die Verwendung der Markuperweiterung, die in anderen Eigenschaften enthalten sind, über den IAmbientProvider Dienst darauf zugreifen können.
DependsOn ist ein ähnliches Konzept, das auch die XAML-Knotenverarbeitungsreihenfolge beeinflusst. DependsOn Sie können jedoch nur für Peer-Member- und Knotenbeziehungen verwendet werden. Sie kann jedoch nicht alle Nachkommen beeinflussen. DependsOn Beeinflusst auch die Einstellung der Objektdiagrammeigenschaft direkt, während die Umgebungstechnik auf Typkonverter oder Markuperweiterungen basiert. In der Umgebungstechnik muss auch eine bestimmte Typkonverter- oder Markuperweiterungsdefinition vorhanden sein. Es ist bis zu jeder Typkonverter- oder Markuperweiterung, um zu bestimmen, wie der Umgebungseigenschaftswert interpretiert und auf den Objektdiagrammspeicherort angewendet werden soll, an dem der Typkonverter oder die Markuperweiterung verwendet wird.
Hinweise zur WPF-Verwendung
Ein Umgebungseigenschaftsszenario, das im WPF-Featuresatz veranschaulicht wird, ist Style.TargetType, was die erforderlichen Eigenschaftennamen-Nachschlagevorgänge für andere Werte qualifizieren kann. In diesem Fall qualifiziert der Style.TargetType Wert die Setter.Property Werte in den XAML-Knoten darunter. Setter.Property verwendet das Typkonverterverhalten für ein DependencyProperty. Dieses Verhalten greift auf den Umgebungswert Style.TargetType zu, indem er aus einem Dienstkontext abfragt GetFirstAmbientValue , der für Typkonverter und Markuperweiterungen verfügbar ist.
Konstruktoren
AmbientPropertyValue(XamlMember, Object) |
Initialisiert eine neue Instanz der AmbientPropertyValue-Klasse. |
Eigenschaften
RetrievedProperty |
Ruft den XAML-Typsystembezeichner ab, der (XamlMember), der die Ambient-Eigenschaft darstellt. |
Value |
Ruft den Wert der Ambient-Eigenschaft ab. |
Methoden
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |