PriorityBinding Clase

Definición

Describe una colección de objetos Binding que se adjunta a una única propiedad de destino de enlace, que recibe su valor del primer enlace de la colección que produce un valor correctamente.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
Herencia
Atributos
Implementaciones

Comentarios

PriorityBindingpermite asociar una propiedad de destino de enlace (destino) con una lista de enlaces.PriorityBinding lets you associate a binding target (target) property with a list of bindings. El primer enlace que devuelve un valor se convierte correctamente en el enlace activo.The first binding that returns a value successfully becomes the active binding.

Un enlace devuelve un valor correctamente si:A binding returns a value successfully if:

  1. La ruta de acceso al origen de enlace se resuelve correctamente.The path to the binding source resolves successfully.

  2. El convertidor de valores, si existe, puede convertir el valor resultante.The value converter, if any, is able to convert the resulting value.

  3. El valor resultante es válido para la propiedad de destino.The resulting value is valid for the target property.

El valor DependencyProperty.UnsetValue no se considera un valor devuelto correcto.The value DependencyProperty.UnsetValue is not considered a successful return value.

La prioridad de los enlaces viene determinada por su orden en la lista.The priority of the bindings is determined by their order in the list. El enlace que aparece en primer lugar en la lista tiene la prioridad más alta.The binding that appears first in the list has the highest priority.

El motor de enlace comienza con el primer enlace de la lista y comprueba si ese enlace devuelve un valor correctamente; Si es así, se utiliza el valor de ese enlace.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 el primer enlace no devuelve un valor correctamente, el motor de enlace examina el segundo enlace para determinar si devuelve un valor correctamente; Si es así, el valor del segundo enlace se convierte en el valor activo.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. Este proceso de comprobación continúa hasta el final de la lista de enlaces.This verification process continues to the end of the list of bindings. Si ninguno de los enlaces devuelve un valor correctamente, el enlace utiliza FallbackValue.If none of the bindings returns a value successfully, the binding uses the FallbackValue.

El motor de enlace continúa escuchando los cambios en todos los enlaces.The binding engine continues to listen for changes on all bindings. Si en algún punto uno de los enlaces que tiene una prioridad más alta devuelve un valor correctamente, el valor de ese enlace se convierte en el valor activo y reemplaza el valor actual.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.

Constructores

PriorityBinding()

Inicializa una nueva instancia de la clase PriorityBinding.Initializes a new instance of the PriorityBinding class.

Propiedades

BindingGroupName

Obtiene o establece el nombre del objeto BindingGroup al que pertenece este enlace.Gets or sets the name of the BindingGroup to which this binding belongs.

(Heredado de BindingBase)
Bindings

Obtiene la colección de objetos Binding que se establece para esta instancia de PriorityBinding.Gets the collection of Binding objects that is established for this instance of PriorityBinding.

Delay

Obtiene o establece la cantidad de tiempo, en milisegundos, que hay que esperar antes de actualizar el origen de enlace después de que cambie el valor en el destino.Gets or sets the amount of time, in milliseconds, to wait before updating the binding source after the value on the target changes.

(Heredado de BindingBase)
FallbackValue

Obtiene o establece el valor que se usa cuando el enlace no puede devolver un valor.Gets or sets the value to use when the binding is unable to return a value.

(Heredado de BindingBase)
StringFormat

Obtiene o establece una cadena que especifica cómo se aplica formato al enlace si muestra el valor enlazado como una cadena.Gets or sets a string that specifies how to format the binding if it displays the bound value as a string.

(Heredado de BindingBase)
TargetNullValue

Obtiene o establece el valor que se utiliza en el destino cuando el valor del origen es null.Gets or sets the value that is used in the target when the value of the source is null.

(Heredado de BindingBase)

Métodos

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ProvideValue(IServiceProvider)

Devuelve un objeto que se debe establecer en la propiedad donde se aplican este enlace y esta extensión.Returns an object that should be set on the property where this binding and extension are applied.

(Heredado de BindingBase)
ShouldSerializeBindings()

Devuelve un valor que indica si los procesos de serialización deben serializar el valor efectivo de la propiedad Bindings en instancias de esta clase.Returns a value that indicates whether serialization processes should serialize the effective value of the Bindings property on instances of this class.

ShouldSerializeFallbackValue()

Devuelve un valor que indica si los procesos de serialización deben serializar el valor efectivo de la propiedad FallbackValue en instancias de esta clase.Returns a value that indicates whether serialization processes should serialize the effective value of the FallbackValue property on instances of this class.

(Heredado de BindingBase)
ShouldSerializeTargetNullValue()

Devuelve un valor que indica si debe serializarse la propiedad TargetNullValue.Returns a value that indicates whether the TargetNullValue property should be serialized.

(Heredado de BindingBase)
ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Implementaciones de interfaz explícitas

IAddChild.AddChild(Object)

Este miembro es compatible con la infraestructura de Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) y no está diseñado para utilizarse directamente desde el código.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)

Este miembro es compatible con la infraestructura de Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) y no está diseñado para utilizarse directamente desde el código.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

Se aplica a

Consulte también: