Partager via


AmbientPropertyValue Classe

Définition

Signale les informations relatives à une propriété ambiante, dans le cadre d'une implémentation de IAmbientProvider.

public ref class AmbientPropertyValue
public class AmbientPropertyValue
type AmbientPropertyValue = class
Public Class AmbientPropertyValue
Héritage
AmbientPropertyValue

Remarques

AmbientPropertyValue représente un élément d’informations retourné par l’appel d’une méthode de IAmbientProvider 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 pour le graphe d’objets en dessous. Le concept ambiant est pertinent pour un processeur XAML pendant la phase d’écriture d’objet du chemin de chargement ou la phase de sérialisation d’un chemin d’enregistrement.

Un type peut également être attribué en tant que ambient. 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 en dessous dans une structure de nœud XAML. Lorsqu’il est traité en tant que flux de nœud XAML, le concept ambiant implique que la valeur de la propriété ambiante doit être disponible pour les convertisseurs de type et les extensions de balisage de StartObject à 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 généré 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 d’abord être traitée 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 la définition des propriétés de graphe d’objets, alors 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 appartient à 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’objets où le convertisseur de type ou l’extension de balisage est utilisé.

Remarques sur l'utilisation de WPF

Un scénario de propriété ambiante illustré dans l’ensemble 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 en dessous. 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

AmbientPropertyValue(XamlMember, Object)

Initialise une nouvelle instance de la classe AmbientPropertyValue.

Propriétés

RetrievedProperty

Obtient l'identificateur du système de type XAML (XamlMember) qui représente la propriété ambiante.

Value

Obtient la valeur de la propriété ambiante.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à

Voir aussi