PriorityBinding Classe

Référence

Définition

Espace de noms:: System.Windows.Data

Assembly:: PresentationFramework.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Décrit une collection d’objets Binding qui est attachée à une propriété de cible de liaison unique, qui reçoit sa valeur de la première liaison de la collection qui génère une valeur avec succès.

public ref class PriorityBinding : System::Windows::Data::BindingBase, System::Windows::Markup::IAddChild

[System.Windows.Markup.ContentProperty("Bindings")]
public class PriorityBinding : System.Windows.Data.BindingBase, System.Windows.Markup.IAddChild

[<System.Windows.Markup.ContentProperty("Bindings")>]
type PriorityBinding = class
    inherit BindingBase
    interface IAddChild

Public Class PriorityBinding
Inherits BindingBase
Implements IAddChild

Héritage: Object

MarkupExtension

BindingBase
PriorityBinding

Attributs: ContentPropertyAttribute

Implémente: IAddChild

Remarques

PriorityBinding vous permet d’associer une propriété cible de liaison (cible) à une liste de liaisons. La première liaison qui retourne une valeur devient la liaison active.

Une liaison retourne une valeur correctement si :

Le chemin d’accès à la source de liaison est résolu avec succès.
Le convertisseur de valeurs, le cas échéant, peut convertir la valeur résultante.
La valeur résultante est valide pour la propriété cible.

La valeur DependencyProperty.UnsetValue n’est pas considérée comme une valeur de retour réussie.

La priorité des liaisons est déterminée par leur ordre dans la liste. La liaison qui apparaît en premier dans la liste a la priorité la plus élevée.

Le moteur de liaison commence par la première liaison de la liste et vérifie si cette liaison retourne une valeur avec succès ; si c’est le cas, la valeur de cette liaison est utilisée. Si la première liaison ne retourne pas une valeur correctement, le moteur de liaison examine la deuxième liaison pour déterminer si elle retourne une valeur avec succès ; si c’est le cas, la valeur de la deuxième liaison devient la valeur active. Ce processus de vérification se poursuit jusqu’à la fin de la liste des liaisons. Si aucune des liaisons ne retourne de valeur correctement, la liaison utilise le FallbackValue.

Le moteur de liaison continue d’écouter les modifications apportées à toutes les liaisons. Si à un moment donné, l’une des liaisons qui a une priorité plus élevée retourne une valeur avec succès, la valeur de cette liaison devient la valeur active et remplace la valeur actuelle.

Constructeurs

PriorityBinding()

Initialise une nouvelle instance de la classe PriorityBinding.

Propriétés

BindingGroupName	Obtient ou définit le nom du BindingGroup auquel appartient cette liaison. (Hérité de BindingBase)
Bindings	Obtient la collection d'objets Binding établie pour cette instance de PriorityBinding.
Delay	Obtient ou définit la durée d'attente, en millisecondes, avant de mettre à jour la source de liaison après le changement de la valeur sur les cibles. (Hérité de BindingBase)
FallbackValue	Obtient ou définit la valeur à utiliser quand la liaison ne peut pas retourner une valeur. (Hérité de BindingBase)
StringFormat	Obtient ou définit une chaîne qui spécifie comment mettre en forme la liaison si elle affiche la valeur liée en tant que chaîne. (Hérité de BindingBase)
TargetNullValue	Obtient ou définit la valeur utilisée dans la cible lorsque la valeur de la source est `null`. (Hérité de BindingBase)

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)
ProvideValue(IServiceProvider)	Retourne un objet qui doit être défini sur la propriété où cette liaison et cette extension sont appliquées. (Hérité de BindingBase)
ShouldSerializeBindings()	Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur effective de la propriété Bindings sur les instances de cette classe.
ShouldSerializeFallbackValue()	Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur effective de la propriété FallbackValue sur les instances de cette classe. (Hérité de BindingBase)
ShouldSerializeTargetNullValue()	Retourne une valeur qui indique si la propriété TargetNullValue doit être sérialisée. (Hérité de BindingBase)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

IAddChild.AddChild(Object)	Ce membre prend en charge l’infrastructure Windows Presentation Foundation (WPF) et n’est pas destiné à être utilisé directement à partir de votre code.
IAddChild.AddText(String)	Ce membre prend en charge l’infrastructure Windows Presentation Foundation (WPF) et n’est pas destiné à être utilisé directement à partir de votre code.

S’applique à