AmbientPropertyValue Classe

Définition

Espace de noms:

System.Xaml

Assembly:

System.Xaml.dll

Signale des informations sur une propriété ambiante, dans le cadre d’une IAmbientProvider implémentation.

public ref class AmbientPropertyValue

public class AmbientPropertyValue

type AmbientPropertyValue = class

Public Class AmbientPropertyValue

Héritage

Object

AmbientPropertyValue

Remarques

AmbientPropertyValue représente un élément d’information retourné par l’appel d’une IAmbientProvider méthode de service. Les GetAll méthodes retournent des énumérations ou des tableaux d’éléments AmbientPropertyValue ; les GetFirst méthodes retournent un seul AmbientPropertyValue.

À propos des propriétés ambiantes

Une propriété ambiante est une propriété dont la valeur de propriété doit être disponible pour l’utilisation du convertisseur de valeurs dans la structure de nœud XAML et dans le graphique d’objets sous celui-ci. Le concept ambiant est pertinent pour un processeur XAML pendant la phase d’écriture d’objet du chemin de chargement ou de la phase de sérialisation d’un chemin d’enregistrement.

Un type peut également être attribué comme ambiant. Dans ce cas, toutes les propriétés qui utilisent le type attribué sont signalées comme ambiantes.

Dans le cas du chemin de chargement, la valeur de propriété ambiante peut influencer la valeur produite par le graphique d’objets d’autres propriétés qui existent sous celle-ci dans une structure de nœud XAML. Lorsqu’elle est traitée en tant que flux de nœud XAML, le concept ambiant implique que la valeur de propriété ambiante doit être disponible pour les convertisseurs de type et les extensions de balisage de StartObject vers EndObject. De même, un convertisseur de type ou une extension de balisage utilisé pour le chemin d’enregistrement peut rechercher la propriété ambiante et sa valeur. Par conséquent, le code XAML produit est une meilleure représentation aller-retour.

Par sa définition de langage, XAML ne spécifie pas l’ordre dans lequel les membres d’un objet doivent être traités. Toutefois, toute valeur de propriété ambiante doit être traitée en premier par le lecteur XAML afin que le convertisseur de type et l’utilisation de l’extension de balisage contenus dans d’autres propriétés puissent y accéder via le IAmbientProvider service.

DependsOn est un concept similaire qui influence également l’ordre de traitement des nœuds XAML. Toutefois, DependsOn ne peut être utilisé que pour les relations de membre d’homologue et de nœud ; il ne peut pas influencer tous les descendants. En outre, DependsOn influence directement le paramètre de propriété du graphe d’objet, tandis que la technique ambiante s’appuie sur des convertisseurs de type ou des extensions de balisage. Dans la technique ambiante, il doit également y avoir un convertisseur de type spécifique ou une définition d’extension de balisage. Il incombe à chaque convertisseur de type ou extension de balisage de déterminer comment la valeur de propriété ambiante doit être interprétée et appliquée à l’emplacement du graphique d’objet où le convertisseur de type ou l’extension de balisage est utilisé.

Notes d’utilisation WPF

Un scénario de propriété ambiante illustré dans le jeu de fonctionnalités WPF est Style.TargetType, qui peut qualifier les recherches de nom de propriété nécessaires pour d’autres valeurs. Dans ce cas, la Style.TargetType valeur qualifie les Setter.Property valeurs dans les nœuds XAML sous celui-ci. Setter.Property utilise le comportement du convertisseur de type pour un DependencyProperty. Ce comportement accède à la valeur ambiante Style.TargetType en interrogeant GetFirstAmbientValue à partir d’un contexte de service disponible pour les convertisseurs de type et les extensions de balisage.

Constructeurs

Nom	Description
AmbientPropertyValue(XamlMember, Object)	Initialise une nouvelle instance de la classe AmbientPropertyValue.

Propriétés

Nom	Description
RetrievedProperty	Obtient l’identificateur système de type XAML (XamlMember) qui représente la propriété ambiante.
Value	Obtient la valeur de la propriété ambiante.

Voir aussi

• IAmbientProvider