PriorityBinding Classe

Définition

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.Describes a collection of Binding objects that is attached to a single binding target property, which receives its value from the first binding in the collection that produces a value successfully.

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
type PriorityBinding = class
    inherit BindingBase
    interface IAddChild
Public Class PriorityBinding
Inherits BindingBase
Implements IAddChild
Héritage
Attributs
Implémente

Remarques

PriorityBindingvous permet d’associer une propriété de cible de liaison (cible) à une liste de liaisons.PriorityBinding lets you associate a binding target (target) property with a list of bindings. La première liaison qui retourne une valeur avec succès devient la liaison active.The first binding that returns a value successfully becomes the active binding.

Une liaison retourne une valeur avec succès si:A binding returns a value successfully if:

  1. Le chemin d’accès à la source de liaison est résolu avec succès.The path to the binding source resolves successfully.

  2. Le convertisseur de valeur, le cas échéant, est en mesure de convertir la valeur résultante.The value converter, if any, is able to convert the resulting value.

  3. La valeur résultante est valide pour la propriété cible.The resulting value is valid for the target property.

La valeur DependencyProperty.UnsetValue n’est pas considérée comme une valeur de retour correcte.The value DependencyProperty.UnsetValue is not considered a successful return value.

La priorité des liaisons est déterminée par leur ordre dans la liste.The priority of the bindings is determined by their order in the list. La liaison qui apparaît en premier dans la liste a la priorité la plus élevée.The binding that appears first in the list has the highest priority.

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.The binding engine starts with the first binding in the list and verifies whether that binding returns a value successfully; if it does, the value from that binding is used. Si la première liaison ne retourne pas de valeur avec succès, le moteur de liaison examine la deuxième liaison pour déterminer si elle retourne correctement une valeur; Si c’est le cas, la valeur de la deuxième liaison devient la valeur active.If the first binding does not return a value successfully, the binding engine examines the second binding to determine whether it returns a value successfully; if it does, the value from the second binding becomes the active value. Ce processus de vérification continue jusqu’à la fin de la liste des liaisons.This verification process continues to the end of the list of bindings. Si aucune des liaisons ne retourne une valeur avec succès, la liaison utilise FallbackValue.If none of the bindings returns a value successfully, the binding uses the FallbackValue.

Le moteur de liaison continue à écouter les modifications sur toutes les liaisons.The binding engine continues to listen for changes on all bindings. Si, à un moment quelconque, 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.If at any point one of the bindings that has a higher priority returns a value successfully, the value for that binding becomes the active value and replaces the current value.

Constructeurs

PriorityBinding()

Initialise une nouvelle instance de la classe PriorityBinding.Initializes a new instance of the PriorityBinding class.

Propriétés

BindingGroupName

Obtient ou définit le nom du BindingGroup auquel appartient cette liaison.Gets or sets the name of the BindingGroup to which this binding belongs.

(Hérité de BindingBase)
Bindings

Obtient la collection d'objets Binding établie pour cette instance de PriorityBinding.Gets the collection of Binding objects that is established for this instance of 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.Gets or sets the amount of time, in milliseconds, to wait before updating the binding source after the value on the target changes.

(Hérité de BindingBase)
FallbackValue

Obtient ou définit la valeur à utiliser quand la liaison ne peut pas retourner une valeur.Gets or sets the value to use when the binding is unable to return a value.

(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.Gets or sets a string that specifies how to format the binding if it displays the bound value as a string.

(Hérité de BindingBase)
TargetNullValue

Obtient ou définit la valeur utilisée dans la cible lorsque la valeur de la source est null.Gets or sets the value that is used in the target when the value of the source is null.

(Hérité de BindingBase)

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(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.Returns an object that should be set on the property where this binding and extension are applied.

(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.Returns a value that indicates whether serialization processes should serialize the effective value of the Bindings property on instances of this class.

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.Returns a value that indicates whether serialization processes should serialize the effective value of the FallbackValue property on instances of this class.

(Hérité de BindingBase)
ShouldSerializeTargetNullValue()

Retourne une valeur qui indique si la propriété TargetNullValue doit être sérialisée.Returns a value that indicates whether the TargetNullValue property should be serialized.

(Hérité de BindingBase)
ToString()

Retourne une chaîne qui représente l'objet en cours.Returns a string that represents the current object.

(Hérité de Object)

Implémentations d’interfaces explicites

IAddChild.AddChild(Object)

Ce membre prend en charge l’infrastructure Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) et n’est pas destiné à être directement utilisé à partir de votre code.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

IAddChild.AddText(String)

Ce membre prend en charge l’infrastructure Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) et n’est pas destiné à être directement utilisé à partir de votre code.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

S’applique à

Voir aussi