AmbientPropertyValue Classe

Definizione

Spazio dei nomi:

System.Xaml

Assembly:

System.Xaml.dll

Fornisce informazioni su una proprietà di ambiente, come parte di un'implementazione IAmbientProvider.

public ref class AmbientPropertyValue

public class AmbientPropertyValue

type AmbientPropertyValue = class

Public Class AmbientPropertyValue

Ereditarietà

Object

AmbientPropertyValue

Commenti

AmbientPropertyValue rappresenta un elemento informativo restituito chiamando un IAmbientProvider metodo di servizio. I metodi restituiscono enumerazioni o matrici di AmbientPropertyValue elementi. I GetAllGetFirst metodi restituiscono un singolo AmbientPropertyValueoggetto .

Informazioni sulle proprietà di ambiente

Una proprietà ambient è una proprietà il cui valore della proprietà deve essere disponibile per l'utilizzo del convertitore di valori nella struttura del nodo XAML e per il grafico a oggetti sottostante. Il concetto di ambiente è rilevante per un processore XAML durante la fase di scrittura dell'oggetto del percorso di carico o la fase di serializzazione di un percorso di salvataggio.

Un tipo può anche essere attribuito come ambiente. In questo caso, tutte le proprietà che usano il tipo con attributi vengono segnalate come ambiente.

Nel caso del percorso di carico, il valore della proprietà ambientale potrebbe influire sul valore prodotto dal grafico dell'oggetto di altre proprietà presenti sotto di esso in una struttura di nodo XAML. Quando viene elaborato come flusso di nodi XAML, il concetto di ambiente implica che il valore della proprietà ambiente deve essere disponibile per i convertitori di tipi e le estensioni di markup da StartObject a EndObject. Analogamente, un convertitore di tipi o un'estensione di markup utilizzata per il percorso di salvataggio può cercare la proprietà ambiente e il relativo valore. Pertanto, il codice XAML prodotto è una rappresentazione di round trip migliore.

In base alla definizione del linguaggio, XAML non specifica l'ordine in cui i membri di un oggetto devono essere elaborati. Tuttavia, qualsiasi valore della proprietà ambientale deve essere elaborato prima dal lettore XAML in modo che il convertitore di tipi e l'utilizzo dell'estensione di markup contenuti in altre proprietà possano accedervi tramite il IAmbientProvider servizio.

DependsOn è un concetto simile che influenza anche l'ordine di elaborazione dei nodi XAML. Tuttavia, DependsOn può essere usato solo per le relazioni tra membri e nodi peer. Non può influire su tutti i discendenti. Inoltre, DependsOn influisce direttamente sull'impostazione della proprietà grafo degli oggetti, mentre la tecnica ambientale si basa su convertitori di tipi o estensioni di markup. Nella tecnica ambientale deve essere presente anche una definizione specifica di convertitore di tipi o estensione di markup. È fino a ogni convertitore di tipi o estensione di markup per determinare il modo in cui il valore della proprietà ambientale deve essere interpretato e applicato alla posizione del grafico dell'oggetto in cui viene usata l'estensione del convertitore di tipi o del markup.

Note sull'utilizzo di WPF

Uno scenario di proprietà ambientale illustrato nel set di funzionalità WPF è Style.TargetType, che può qualificare le ricerche necessarie per i nomi delle proprietà necessarie per altri valori. In questo caso, il Style.TargetType valore qualifica i Setter.Property valori nei nodi XAML sottostanti. Setter.Property usa il comportamento del convertitore di tipi per un DependencyPropertyoggetto . Questo comportamento accede al valore ambientale Style.TargetType eseguendo una query GetFirstAmbientValue da un contesto di servizio disponibile per i convertitori di tipi e le estensioni di markup.

Costruttori

AmbientPropertyValue(XamlMember, Object)

Inizializza una nuova istanza della classe AmbientPropertyValue.

Proprietà

RetrievedProperty	Ottiene l'identificatore di sistema dei tipi XAML (XamlMember) che rappresenta la proprietà di ambiente.
Value	Ottiene il valore della proprietà di ambiente.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• IAmbientProvider