Enlaces Class

Define un enlace que conecta las propiedades de destinos de enlace y de orígenes de datos.

Herencia

Object
  DependencyObject
    BindingBase
      Binding

Sintaxis


public class Binding : BindingBase


<dependencyobject dependencyproperty="{Binding bindingArgs}" />

XAML Values

bindingArgs

Argumentos para un uso de la extensión de marcado {Binding} . El uso de {Binding} puede incluir un valor implícito de Path o uno o más pares propertyname=value que establecen las propiedades de la clase Binding. Todas las propiedades de lectura y escritura de la clase Binding se pueden establecer con el uso de la extensión de marcado de {Binding} , aunque algunas requieren extensiones adicionales de marcado para sus valores. Para obtener más información sobre esta sintaxis y la sintaxis de la cadena de cada argumento, vea Extensiones de marcado de enlaces. Si el DataContext existente proporciona suficiente información de enlace, puede utilizar "{Binding}" sin argumentos.

Atributos

[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]
[WebHostHidden()]

Members

A continuación se indican los tipos de miembros de Binding (Clase):

Constructores

A continuación se indican los constructores de Binding (Clase).

ConstructorDescripción
Binding Initializes a new instance of the Binding class.

 

Métodos

The Binding Clase tiene estos métodos. También hereda métodos de Object Clase.

MétodoDescripción
ClearValue Clears the local value of a dependency property. (Se hereda de DependencyObject)
GetAnimationBaseValue Returns any base value established for a dependency property, which would apply in cases where an animation is not active. (Se hereda de DependencyObject)
GetValue Returns the current effective value of a dependency property from a DependencyObject. (Se hereda de DependencyObject)
ReadLocalValue Returns the local value of a dependency property, if a local value is set. (Se hereda de DependencyObject)
SetValue Sets the local value of a dependency property on a DependencyObject. (Se hereda de DependencyObject)

 

Propiedades

BindingClase tiene estas propiedades.

PropiedadTipo de accesoDescripción

Converter

Lectura/escrituraGets or sets the converter object that is called by the binding engine to modify the data as it is passed between the source and target, or vice versa.

ConverterLanguage

Lectura/escrituraGets or sets a value that names the language to pass to any converter specified by the Converter property.

ConverterParameter

Lectura/escrituraGets or sets a parameter that can be used in the Converter logic.

Dispatcher

De sólo lecturaGets the CoreDispatcher that this object is associated with. (Se hereda de DependencyObject)

ElementName

Lectura/escrituraGets or sets the name of the element to use as the binding source for the Binding.

FallbackValue

Lectura/escrituraGets or sets the value to use when the binding is unable to return a value.

Mode

Lectura/escrituraGets or sets a value that indicates the direction of the data flow in the binding.

Path

Lectura/escrituraGets or sets the path to the binding source property.

RelativeSource

Lectura/escrituraGets or sets the binding source by specifying its location relative to the position of the binding target. This is most often used in bindings within XAML control templates.

Source

Lectura/escrituraGets or sets the data source for the binding.

TargetNullValue

Lectura/escrituraGets or sets the value that is used in the target when the value of the source is null.

UpdateSourceTrigger

Lectura/escrituraGets or sets a value that determines the timing of binding source updates for two-way bindings.

 

Comentarios

La extensión de marcado Binding permite especificar un valor de Binding como una cadena de atributo única en XAML, incluido el establecimiento de propiedades Binding como Path y Source. Para obtener más información sobre conceptos de enlace de datos, vea Introducción al enlace de datos.

La clase Binding se podría considerar la exposición de código subyacente de la Extensión de marcado Binding. Si un enlace ya está aplicado a un destino (lo que sucede cuando se carga el XAML), no puede establecer las propiedades de lectura y escritura de un objeto Binding para cambiar la manera en que un enlace se comporta en tiempo de ejecución. Cualquier enlace definido mediante XAML debe considerarse invariable. Sin embargo, puede crear un nuevo objeto Binding, definir sus propiedades y establecer un nuevo enlace en un destino de elemento de la interfaz de usuario determinado utilizando el método FrameworkElement.SetBinding. Para obtener más información, vea la sección Crear enlaces en código de Introducción al enlace de datos.

Un objeto Binding conecta directamente una propiedad de dependencia de FrameworkElement a un objeto de datos para que las actualizaciones del objeto de datos se propaguen automáticamente a la propiedad que usa un enlace de datos. La clase Binding define las propiedades de un enlace. Cada enlace debe tener un elemento de destino, propiedad de destino y origen de datos, aunque de forma predeterminada se proporcionan algunos valores si no los especifica.

Para enlazar a una propiedad o una subpropiedad en un objeto de datos, establezca la propiedad Path del objeto Binding. Para obtener más información sobre cómo establecer Path en código o en XAML, vea Sintaxis de PropertyPath o Extensión de marcado Binding.

Una instancia de una clase Binding se puede aplicar a varios destinos. Sin embargo, no puede modificar los valores de propiedad de un objeto Binding después de adjuntarlo a un elemento de destino.

Nota  Llamar al método FrameworkElement.SetBinding y pasar un nuevo objeto Binding no quita necesariamente un enlace existente. Debe usar el método DependencyObject.ClearValue en su lugar.

Para obtener más información sobre el uso del atributo XAML en las propiedades que pueden tener un objeto Binding o que, de lo contrario, pueden establecerse en un valor enlazado a datos, vea Extensión de marcado Binding.

La propiedad que es destino de un enlace de datos debe ser de dependencia. Para obtener más información, vea Información general sobre las propiedades de dependencia.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear un enlace en XAML. Para obtener el código completo, vea el ejemplo de enlace de datos XAML.


<StackPanel Margin="5">

  <TextBlock Text="Name:" Style="{StaticResource DescriptionTextStyle}" 
    Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

  <TextBox Text="{Binding Path=Name, Mode=TwoWay}" 
    Width="350" Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

  <TextBlock Text="Organization:" Style="{StaticResource DescriptionTextStyle}" 
    Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

  <!-- You can omit the 'Path=' portion of the binding expression. --> 
  <TextBox Text="{Binding Organization, Mode=TwoWay}" Width="350" 
    Margin="5" HorizontalAlignment="Left" VerticalAlignment="Top"/>

</StackPanel>

En el ejemplo de código siguiente se muestra cómo crear un enlace en el código.


// Create the source string.
string s = "Hello";

// Create the binding description.
Binding b = new Binding();
b.Mode = BindingMode.OneTime;
b.Source = s;

// Attach the binding to the target.
MyText.SetBinding(TextBlock.TextProperty, b);


Requisitos

Cliente mínimo admitido

Windows 8 [Solo aplicaciones de la Tienda Windows]

Servidor mínimo admitido

Windows Server 2012 [Solo aplicaciones de la Tienda Windows]

Espacio de nombres

Windows.UI.Xaml.Data
Windows::UI::Xaml::Data [C++]

Metadatos

Windows.winmd

Vea también

Ejemplo de enlace de datos XAML
Introducción al enlace de datos
Información general sobre las propiedades de dependencia
BindingOperations.SetBinding

 

 

Mostrar:
© 2015 Microsoft