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 dla użycia konwertera wartości w strukturze węzła XAML i do grafu obiektu pod nim. 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 atrybutu są zgłaszane jako otoczenia.

W przypadku ścieżki obciążenia 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 tworzony kod XAML jest lepszą reprezentacją w obie strony.

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 niego 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 dla relacji elementów członkowskich i węzłów równorzędnych; nie może mieć wpływu na wszystkie elementy potomne. Ponadto bezpośrednio DependsOn wpływa na ustawienie właściwości grafu obiektów, podczas gdy technika otoczenia opiera się na konwerterach typów lub rozszerzeniach znaczników. W technice otoczenia musi istnieć również określony konwerter typów lub definicja rozszerzenia znaczników. Jest to 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 pod nim. Setter.Property używa zachowania konwertera typów dla elementu DependencyProperty. To zachowanie uzyskuje dostęp do wartości otoczenia Style.TargetType przez wykonywanie zapytań GetFirstAmbientValue z kontekstu usługi, który jest dostępny dla konwerterów typów i rozszerzeń znaczników.

Konstruktory

Nazwa	Opis
AmbientPropertyValue(XamlMember, Object)	Inicjuje nowe wystąpienie klasy AmbientPropertyValue.

Właściwości

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

Zobacz też

• IAmbientProvider