Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase Binding

 

Publicado: octubre de 2016

Proporciona acceso de alto nivel a la definición de un enlace, que conecta las propiedades de objetos de destino de enlace (normalmente, elementos WPF) y cualquier origen de datos (por ejemplo, una base de datos, un archivo XML o cualquier objeto que contenga datos).

Espacio de nombres:   System.Windows.Data
Ensamblado:  PresentationFramework (en PresentationFramework.dll)


public class Binding : BindingBase

NombreDescripción
System_CAPS_pubmethodBinding()

Inicializa una nueva instancia de la clase Binding.

System_CAPS_pubmethodBinding(String)

Inicializa una nueva instancia de la clase Binding con una ruta de acceso inicial.

NombreDescripción
System_CAPS_pubpropertyAsyncState

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene o establece los datos opacos pasados al distribuidor de datos asincrónicos.

System_CAPS_pubpropertyBindingGroupName

Obtiene o establece el nombre de la BindingGroup al que pertenece este enlace.(Heredado de BindingBase).

System_CAPS_pubpropertyBindsDirectlyToSource

Obtiene o establece un valor que indica si se debe evaluar la propiedad Path en relación con el elemento de datos o el objeto DataSourceProvider.

System_CAPS_pubpropertyConverter

Obtiene o establece el convertidor a utilizar.

System_CAPS_pubpropertyConverterCulture

Obtiene o establece la referencia cultural en la que se evaluará el convertidor.

System_CAPS_pubpropertyConverterParameter

Obtiene o establece el parámetro que se pasa a la Converter.

System_CAPS_pubpropertyDelay

Obtiene o establece la cantidad de tiempo, en milisegundos, que se esperará antes de actualizar el origen de enlace después del valor de los cambios de destino.(Heredado de BindingBase).

System_CAPS_pubpropertyElementName

Obtiene o establece el objeto del elemento que se va a usar como objeto de origen de enlace.

System_CAPS_pubpropertyFallbackValue

Obtiene o establece el valor que se usa cuando el enlace no puede devolver un valor.(Heredado de BindingBase).

System_CAPS_pubpropertyIsAsync

Obtiene o establece un valor que indica si Binding debe obtener y establecer valores de forma asincrónica.

System_CAPS_pubpropertyMode

Obtiene o establece un valor que indica la dirección del flujo de datos en el enlace.

System_CAPS_pubpropertyNotifyOnSourceUpdated

Obtiene o establece un valor que indica si se generará el evento SourceUpdated cuando se transfiere un valor desde el destino de enlace al origen de enlace.

System_CAPS_pubpropertyNotifyOnTargetUpdated

Obtiene o establece un valor que indica si se genera el evento TargetUpdated cuando un valor se transfiere desde el origen de enlace al destino de enlace.

System_CAPS_pubpropertyNotifyOnValidationError

Obtiene o establece un valor que indica si se genera el evento adjunto Error en el objeto enlazado.

System_CAPS_pubpropertyPath

Obtiene o establece la ruta de acceso a la propiedad de origen de enlace.

System_CAPS_pubpropertyRelativeSource

Obtiene o establece el origen de enlace especificando su ubicación en relación con la posición del destino de enlace.

System_CAPS_pubpropertySource

Obtiene o establece el objeto que se va a usar como origen de enlace.

System_CAPS_pubpropertyStringFormat

Obtiene o establece una cadena que especifica cómo se aplica formato al enlace si muestra el valor enlazado como una cadena.(Heredado de BindingBase).

System_CAPS_pubpropertyTargetNullValue

Obtiene o establece el valor que se usa en el destino cuando el valor de origen es null.(Heredado de BindingBase).

System_CAPS_pubpropertyUpdateSourceExceptionFilter

Obtiene o establece un controlador que puede usar para ofrecer lógica personalizada para controlar las excepciones que el motor de enlace encuentra durante la actualización del valor del origen de enlace. Esto solo es aplicable si se asoció una ExceptionValidationRule al enlace.

System_CAPS_pubpropertyUpdateSourceTrigger

Obtiene o establece un valor que determina los intervalos de las actualizaciones del origen de enlace.

System_CAPS_pubpropertyValidatesOnDataErrors

Obtiene o establece un valor que indica si se debe incluir el DataErrorValidationRule.

System_CAPS_pubpropertyValidatesOnExceptions

Obtiene o establece un valor que indica si se debe incluir el ExceptionValidationRule.

System_CAPS_pubpropertyValidatesOnNotifyDataErrors

Obtiene o establece un valor que indica si se debe incluir el NotifyDataErrorValidationRule.

System_CAPS_pubpropertyValidationRules

Obtiene una colección de reglas que comprueban la validez de la entrada del usuario.

System_CAPS_pubpropertyXPath

Obtiene o establece una consulta XPath que devuelve el valor en el origen de enlace XML que se debe usar.

NombreDescripción
System_CAPS_pubpropertySystem_CAPS_staticXmlNamespaceManager

Obtiene o establece la XmlNamespaceManager utilizada para realizar la cuenta para el espacio de nombres XPath consultas en XML enlaces.

NombreDescripción
System_CAPS_pubmethodSystem_CAPS_staticAddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Agrega un controlador para el evento adjunto SourceUpdated.

System_CAPS_pubmethodSystem_CAPS_staticAddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Agrega un controlador para el evento adjunto TargetUpdated.

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodSystem_CAPS_staticGetXmlNamespaceManager(DependencyObject)

Establece un objeto de administrador de espacio de nombres XML que usa el enlace adjunto al objeto especificado.

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodProvideValue(IServiceProvider)

Devuelve un objeto que se debe establecer en la propiedad donde se aplican este enlace y esta extensión.(Heredado de BindingBase).

System_CAPS_pubmethodSystem_CAPS_staticRemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Quita un controlador del evento adjunto SourceUpdated.

System_CAPS_pubmethodSystem_CAPS_staticRemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Quita un controlador del evento adjunto TargetUpdated.

System_CAPS_pubmethodSystem_CAPS_staticSetXmlNamespaceManager(DependencyObject, XmlNamespaceManager)

Establece un objeto del administrador de espacios de nombres que usa el enlace adjunto al elemento proporcionado.

System_CAPS_pubmethodShouldSerializeFallbackValue()

Devuelve un valor que indica si los procesos de serialización deben serializar el valor efectivo de la FallbackValue propiedad en las instancias de esta clase.(Heredado de BindingBase).

System_CAPS_pubmethodShouldSerializePath()

Indica si la propiedad Path debe persistir.

System_CAPS_pubmethodShouldSerializeSource()

Indica si la propiedad Source debe persistir.

System_CAPS_pubmethodShouldSerializeTargetNullValue()

Devuelve un valor que indica si la TargetNullValue se debe serializar la propiedad.(Heredado de BindingBase).

System_CAPS_pubmethodShouldSerializeValidationRules()

Indica si la propiedad ValidationRules debe persistir.

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

NombreDescripción
System_CAPS_pubfieldSystem_CAPS_staticDoNothing

Se utiliza como un valor devuelto para indicar al motor de enlace que no realice ninguna acción.

System_CAPS_pubfieldSystem_CAPS_staticIndexerName

Usar como la PropertyName de System.ComponentModel.PropertyChangedEventArgs para indicar que ha cambiado una propiedad de indizador.

System_CAPS_pubfieldSystem_CAPS_staticSourceUpdatedEvent

Identifica el evento adjunto SourceUpdated.

System_CAPS_pubfieldSystem_CAPS_staticTargetUpdatedEvent

Identifica el evento adjunto TargetUpdated.

System_CAPS_pubfieldSystem_CAPS_staticXmlNamespaceManagerProperty

Identifica la propiedad adjunta XmlNamespaceManager.

NombreDescripción
System_CAPS_pubeventSystem_CAPS_staticSourceUpdated

Se produce cuando se transfiere un valor desde el destino de enlace al origen de enlace, pero solo para los enlaces con el valor NotifyOnSourceUpdated establecido en true.

System_CAPS_pubeventSystem_CAPS_staticTargetUpdated

Se produce cuando se transfiere un valor desde el origen de enlace al destino de enlace, pero solo para los enlaces con el valor NotifyOnTargetUpdated establecido en true.

Windows Presentation Foundation (WPF) data binding provides a simple and consistent way for applications to present and interact with data. Data binding enables you to synchronize the values of the properties of two different objects.

To establish a binding, use the T:System.Windows.Data.Binding class or one of the other classes that inherit T:System.Windows.Data.BindingBase. Regardless of what object you are binding and the nature of your data source, each binding follows the model illustrated by the following figure.

Diagrama de enlace de datos básico

The figure demonstrates the following fundamental TLA2#tla_winclient data binding concepts.

  • Each binding typically has these four components: a binding target object, a target property, a binding source, and a P:System.Windows.Data.Binding.Path to the value in the binding source to use. For example, if you want to bind the content of a T:System.Windows.Controls.TextBox to the Name property of an Employee object, your target object is the T:System.Windows.Controls.TextBox, the target property is the P:System.Windows.Controls.TextBox.Text property, the value to use is Name, and the source object is the Employee object.

  • The target property must be a dependency property. This also means that you cannot bind a field. Most properties of T:System.Windows.UIElement objects are dependency properties and most dependency properties, except read-only ones, support data binding by default. (Only T:System.Windows.DependencyObject types can define dependency properties and all T:System.Windows.UIElement objects derive from T:System.Windows.DependencyObject.)

  • Although not specified in the figure, it should be noted that the binding source object is not restricted to being a custom TLA2#tla_clr object. TLA2#tla_winclient data binding supports data in the form of TLA2#tla_clr objects and TLA2#tla_xml. To provide some examples, your binding source may be a T:System.Windows.UIElement, any list object, a TLA2#tla_clr object that is associated with TLA#tla_adonet data or Web Services, or an XmlNode that contains your TLA2#tla_xml data.

Use the P:System.Windows.Data.Binding.Mode property to specify the direction of the data flow. To detect source changes in one-way or two-way bindings, the source must implement a suitable property change notification mechanism such as T:System.ComponentModel.INotifyPropertyChanged. For an example, see How to: Implement Property Change Notification. The P:System.Windows.Data.Binding.UpdateSourceTrigger property specifies the timing of source updates. For more information, see "Basic Data Binding Concepts" in Data Binding Overview.

<object property="{Binding declaration}"/>

declaration

Zero or more attribute-assignment clauses separated by commas (,). For more information, see Binding Markup Extension or Binding Declarations Overview.

.NET Framework
Disponible desde 3.0
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: