AmbientPropertyValue Klasa

Definicja

Przestrzeń nazw:

System.Xaml

Zestaw:

System.Xaml.dll

Raportuje informacje o właściwości otoczenia w ramach implementacji IAmbientProvider .

public ref class AmbientPropertyValue

public class AmbientPropertyValue

type AmbientPropertyValue = class

Public Class AmbientPropertyValue

Dziedziczenie

Object

AmbientPropertyValue

Uwagi

AmbientPropertyValue reprezentuje element informacji zwracany przez wywołanie IAmbientProvider metody usługi. Metody GetAll zwracają wyliczenia lub tablice AmbientPropertyValue elementów; GetFirst metody zwracają pojedynczy AmbientPropertyValueelement .

Informacje o właściwościach otoczenia

Właściwość otoczenia jest właściwością, której wartość właściwości powinna być dostępna do użycia konwertera wartości w strukturze węzła XAML i do grafu obiektu poniżej. Koncepcja otoczenia jest odpowiednia dla procesora XAML w fazie zapisywania obiektów ścieżki ładowania lub fazy serializacji ścieżki zapisu.

Typ można również przypisać jako otoczenia. W tym przypadku wszystkie właściwości używające typu przypisanego są zgłaszane jako otoczenia.

W przypadku ścieżki ładowania wartość właściwości otoczenia może mieć wpływ na wykres obiektu wygenerowany wartość innych właściwości, które istnieją pod nią w strukturze węzła XAML. W przypadku przetwarzania jako strumienia węzła XAML koncepcja otoczenia oznacza, że wartość właściwości otoczenia musi być dostępna dla konwerterów typów i rozszerzeń znaczników z StartObject do EndObject. Podobnie konwerter typów lub rozszerzenie znaczników używane do ścieżki zapisywania może wyszukać właściwość otoczenia i jego wartość. W związku z tym generowany kod XAML jest lepszą reprezentacją dwukierunkową.

Zgodnie z definicją języka język XAML nie określa kolejności przetwarzania elementów członkowskich obiektu. Jednak każda wartość właściwości otoczenia musi być najpierw przetworzona przez czytnik XAML, aby konwerter typów i użycie rozszerzenia znaczników zawarte w innych właściwościach mogły uzyskać do niej dostęp za pośrednictwem IAmbientProvider usługi.

DependsOn jest podobną koncepcją, która ma również wpływ na kolejność przetwarzania węzłów XAML. DependsOn Można jednak używać tylko w przypadku relacji elementów członkowskich i węzłów równorzędnych. Nie może ona mieć wpływu na wszystkie elementy podrzędne. Ponadto bezpośrednio DependsOn wpływa na ustawienie właściwości grafu obiektów, natomiast technika otoczenia opiera się na konwerterach typów lub rozszerzeniach znaczników. W technice otoczenia musi być również określony konwerter typów lub definicja rozszerzenia znaczników. Należy do każdego konwertera typów lub rozszerzenia znaczników, aby określić, w jaki sposób wartość właściwości otoczenia powinna być interpretowana i stosowana do lokalizacji grafu obiektu, w której jest używany konwerter typów lub rozszerzenie znaczników.

Uwagi dotyczące użycia platformy WPF

Scenariusz właściwości otoczenia przedstawiony w zestawie funkcji WPF to Style.TargetType, który może kwalifikować niezbędne wyszukiwania nazw właściwości dla innych wartości. W takim przypadku Style.TargetType wartość kwalifikuje Setter.Property wartości w węzłach XAML poniżej. Setter.Property używa zachowania konwertera typów dla klasy DependencyProperty. To zachowanie uzyskuje dostęp do wartości otoczenia Style.TargetType przez wysyłanie zapytań GetFirstAmbientValue z kontekstu usługi, który jest dostępny do typów konwerterów i rozszerzeń znaczników.

Konstruktory

AmbientPropertyValue(XamlMember, Object)

Inicjuje nowe wystąpienie klasy AmbientPropertyValue.

Właściwości

RetrievedProperty	Pobiera identyfikator systemu typu XAML (XamlMember), który reprezentuje właściwość otoczenia.
Value	Pobiera wartość właściwości otoczenia.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• IAmbientProvider