PriorityBinding Classe

Definizione

Descrive una raccolta di oggetti Binding associata a una singola proprietà di destinazione del binding, che riceve il valore dal primo binding della raccolta che produce un valore correttamente.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
Ereditarietà
Attributi
Implementazioni

Commenti

PriorityBindingconsente di associare una proprietà di destinazione del binding (destinazione) a un elenco di associazioni.PriorityBinding lets you associate a binding target (target) property with a list of bindings. Il primo binding che restituisce un valore viene convertito correttamente nell'associazione attiva.The first binding that returns a value successfully becomes the active binding.

Un'associazione restituisce correttamente un valore se:A binding returns a value successfully if:

  1. Il percorso dell'origine di associazione viene risolto correttamente.The path to the binding source resolves successfully.

  2. Il convertitore di valori, se presente, è in grado di convertire il valore risultante.The value converter, if any, is able to convert the resulting value.

  3. Il valore risultante è valido per la proprietà di destinazione.The resulting value is valid for the target property.

Il valore DependencyProperty.UnsetValue non viene considerato un valore restituito con esito positivo.The value DependencyProperty.UnsetValue is not considered a successful return value.

La priorità delle associazioni è determinata dall'ordine nell'elenco.The priority of the bindings is determined by their order in the list. Il binding visualizzato per primo nell'elenco ha la priorità più alta.The binding that appears first in the list has the highest priority.

Il motore di associazione inizia con la prima associazione nell'elenco e verifica se tale associazione restituisce correttamente un valore; in caso contrario, viene utilizzato il valore di tale associazione.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. Se il primo binding non restituisce correttamente un valore, il motore di binding esamina la seconda associazione per determinare se restituisce un valore correttamente; in caso contrario, il valore del secondo binding diventa il valore attivo.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. Questo processo di verifica continua fino alla fine dell'elenco di associazioni.This verification process continues to the end of the list of bindings. Se nessuna delle associazioni restituisce correttamente un valore, l'associazione utilizza FallbackValue.If none of the bindings returns a value successfully, the binding uses the FallbackValue.

Il motore di associazione continua a restare in ascolto delle modifiche in tutte le associazioni.The binding engine continues to listen for changes on all bindings. Se in qualsiasi momento una delle associazioni con una priorità più alta restituisce un valore, il valore di tale binding diventa il valore attivo e sostituisce il valore corrente.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.

Costruttori

PriorityBinding()

Inizializza una nuova istanza della classe PriorityBinding.Initializes a new instance of the PriorityBinding class.

Proprietà

BindingGroupName

Ottiene o imposta il nome dell'oggetto BindingGroup a cui appartiene questa associazione.Gets or sets the name of the BindingGroup to which this binding belongs.

(Ereditato da BindingBase)
Bindings

Ottiene l'insieme di oggetti Binding stabilito per questa istanza di PriorityBinding.Gets the collection of Binding objects that is established for this instance of PriorityBinding.

Delay

Ottiene o imposta l'intervallo di tempo, in millisecondi, per l'attesa prima di aggiornare l'origine di associazione dopo la modifica del valore della destinazione.Gets or sets the amount of time, in milliseconds, to wait before updating the binding source after the value on the target changes.

(Ereditato da BindingBase)
FallbackValue

Ottiene o imposta il valore da usare quando l'associazione non è in grado di restituire un valore.Gets or sets the value to use when the binding is unable to return a value.

(Ereditato da BindingBase)
StringFormat

Ottiene o imposta una stringa che specifica come formattare l'associazione se il valore associato viene visualizzato come stringa.Gets or sets a string that specifies how to format the binding if it displays the bound value as a string.

(Ereditato da BindingBase)
TargetNullValue

Ottiene o imposta il valore utilizzato nella destinazione quando il valore dell'origine è null.Gets or sets the value that is used in the target when the value of the source is null.

(Ereditato da BindingBase)

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ProvideValue(IServiceProvider)

Restituisce un oggetto che deve essere impostato sulla proprietà in cui vengono applicate l'associazione e l'estensione.Returns an object that should be set on the property where this binding and extension are applied.

(Ereditato da BindingBase)
ShouldSerializeBindings()

Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore effettivo della proprietà Bindings su istanze di questa classe.Returns a value that indicates whether serialization processes should serialize the effective value of the Bindings property on instances of this class.

ShouldSerializeFallbackValue()

Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore effettivo della proprietà FallbackValue su istanze di questa classe.Returns a value that indicates whether serialization processes should serialize the effective value of the FallbackValue property on instances of this class.

(Ereditato da BindingBase)
ShouldSerializeTargetNullValue()

Restituisce un valore che indica se la proprietà TargetNullValue deve essere serializzata.Returns a value that indicates whether the TargetNullValue property should be serialized.

(Ereditato da BindingBase)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

IAddChild.AddChild(Object)

Questo membro supporta l'infrastruttura di Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) e non deve essere usato direttamente dal codice.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)

Questo membro supporta l'infrastruttura di Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) e non deve essere usato direttamente dal codice.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

Si applica a

Vedi anche