Extensión de marcado {Binding}

La extensión de marcado {Binding} se usa para enlazar propiedades de datos en controles a valores procedentes de un origen de datos como código. La extensión de marcado {Binding} se convierte durante la carga de XAML en una instancia de la clase Binding. Este objeto de enlace obtiene un valor de una propiedad de un origen de datos y lo inserta en la propiedad del control . El objeto de enlace se puede configurar opcionalmente para observar los cambios en el valor de la propiedad del origen de datos y actualizarse en función de esos cambios. También se puede configurar opcionalmente para insertar cambios en el valor de control de nuevo en la propiedad de origen. La propiedad que es el destino de un enlace de datos debe ser una propiedad de dependencia. Para obtener más información, consulte Introducción a las propiedades de dependencia.

{Binding} tiene la misma precedencia de propiedad de dependencia que un valor local y establecer un valor local en código imperativo quita el efecto de cualquier {Binding} establecido en el marcado.

Uso de atributos XAML

<object property="{Binding}" .../>
-or-
<object property="{Binding propertyPath}" .../>
-or-
<object property="{Binding bindingProperties}" .../>
-or-
<object property="{Binding propertyPath, bindingProperties}" .../>

Ruta de acceso de la propiedad

Path describe la propiedad a la que está enlazando (la propiedad de origen). Path es un parámetro posicional, lo que significa que puede usar el nombre del parámetro explícitamente ({Binding Path=EmployeeID}) o puede especificarlo como el primer parámetro sin nombre ({Binding EmployeeID}).

El tipo de Path es una ruta de propiedad, que es una cadena que se evalúa como una propiedad o una subpropiedad de su tipo personalizado o de un tipo de framework. El tipo puede ser, pero no es necesario, un DependencyObject. Los pasos de una ruta de acceso de propiedad se delimitan por puntos (.) y puede incluir varios delimitadores para recorrer las subpropiedades sucesivas. Use el delimitador de puntos independientemente del lenguaje de programación utilizado para implementar el objeto al que se enlaza.

Por ejemplo, para enlazar la interfaz de usuario a la propiedad nombre de un objeto empleado, la ruta de acceso de la propiedad podría ser "Empleado.Nombre". Si vas a enlazar un control de elementos a una propiedad que contiene los dependientes de un empleado, la ruta de acceso de la propiedad podría ser "Employee.Dependents", y la plantilla de elementos del control se encargará de mostrar los elementos en "Dependientes".

Si el origen de datos es una colección, una ruta de acceso de propiedad puede especificar elementos de la colección por su posición o índice. Por ejemplo, "Teams[0].Players", donde la expresión "[]" encierra el "0" que especifica el primer elemento de una colección.

Al usar un enlace ElementName a un DependencyObject existente, puede usar propiedades adjuntas como parte de la ruta de acceso de la propiedad. Para desambiguar una propiedad adjunta, de modo que el punto intermedio del nombre de la propiedad adjunta no se considere un paso en una ruta de acceso de propiedad, coloque entre paréntesis el nombre de la propiedad adjunta calificado por su propietario; por ejemplo, (AutomationProperties.Name).

Un objeto intermedio de ruta de acceso de propiedad se almacena como un objeto PropertyPath en una representación en tiempo de ejecución, pero la mayoría de los escenarios no necesitarán interactuar con un objeto PropertyPath en el código. Normalmente, puedes especificar la información de enlace que necesitas mediante XAML.

Para obtener más información sobre la sintaxis de cadena de caracteres de una ruta de acceso de propiedad, las rutas de acceso de propiedades en las áreas de características de animación y la construcción de un objeto PropertyPath, vea Sintaxis de rutas de acceso a propiedades.

Propiedades de la clase Binding que se puede establecer con {Binding}

{Binding} se muestra con la sintaxis de marcador de posición bindingProperties porque hay varias propiedades de lectura y escritura de un Binding que se pueden establecer en la extensión de marcado. Las propiedades se pueden establecer en cualquier orden con pares devalores= separados por comas. Algunas de las propiedades requieren tipos que no tienen una conversión de tipos, por lo que requieren extensiones de marcado propias anidadas dentro de {Binding}.

Converter, ConverterLanguage y ConverterLanguage están relacionados con el escenario de convertir un valor o tipo del origen de enlace en un tipo o valor compatible con la propiedad de destino de enlace. Para obtener más información y ejemplos, consulte la sección "Conversiones de datos" del enlace de datos en profundidad.

Source, RelativeSource y ElementName especifican un origen de enlace, por lo que son mutuamente excluyentes.

Examples

<!-- binding a UI element to a view model -->
<Page ... >
    <Page.DataContext>
        <local:BookstoreViewModel/>
    </Page.DataContext>

    <GridView ItemsSource="{Binding BookSkus}" SelectedItem="{Binding SelectedBookSku, Mode=TwoWay}" ... />
</Page>

<!-- binding a UI element to another UI element -->
<Page ... >
    <Page.Resources>
        <local:S2Formatter x:Key="GradeConverter"/>
    </Page.Resources>

    <Slider x:Name="sliderValueConverter" ... />
    <TextBox Text="{Binding Path=Value, ElementName=sliderValueConverter,
        Mode=OneWay,
        Converter={StaticResource GradeConverter}}"/>
</Page>

En el segundo ejemplo se establecen cuatro propiedades binding diferentes: ElementName, Path, Mode y Converter. Ruta en este caso se muestra explícitamente como una propiedad denominada Binding. La Path se evalúa como un origen de enlace de datos que es otro objeto en el mismo árbol de objetos en tiempo de ejecución, un control deslizante denominado sliderValueConverter.

Tenga en cuenta cómo el valor de la propiedad Converter usa otra extensión de marcado, {StaticResource}, por lo que hay dos usos de extensiones de marcado anidadas aquí. El elemento interno se evalúa primero, por lo que una vez que se ha obtenido el recurso, hay un IValueConverter práctico (una clase personalizada instanciada por el elemento local:S2Formatter en los recursos) que la vinculación puede usar.

Compatibilidad con herramientas

Microsoft IntelliSense en Microsoft Visual Studio muestra las propiedades del contexto de datos al crear {Binding} en el editor de marcado XAML. En cuanto escriba "{Binding", las propiedades de contexto de datos adecuadas para Path se muestran en la lista desplegable. IntelliSense también ayuda con las otras propiedades de Binding. Para que esto funcione, debe tener ya sea el contexto de datos o el contexto de datos en tiempo de diseño establecido en la página de marcado. Ir a Definición (F12) también funciona con {Binding}. Como alternativa, puede usar el cuadro de diálogo de enlace de datos.