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 en tiempo de carga 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 prioridad de propiedad de dependencia que un valor local y el establecimiento de un valor local en código imperativo quita el efecto de cualquier {Binding} establecido en el marcado.

Uso del atributo 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 acceso de propiedad, que es una cadena que se evalúa como una propiedad o una subpropiación de su tipo personalizado o de un tipo de marco. 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 name de un objeto employee, la ruta de acceso de la propiedad podría ser "Employee.FirstName". Si va 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 elemento del control items se ocuparía 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]. Jugadores", donde el literal "[]" incluye 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 para que el punto intermedio del nombre de la propiedad adjunta no se considere un paso en una ruta de acceso de propiedad, coloque paréntesis alrededor del nombre de propiedad adjunta calificado por el 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 una ruta de acceso de propiedad, las rutas de acceso de propiedades en áreas de características de animación y la construcción de un objeto PropertyPath, vea Sintaxis de ruta de acceso de propiedad.

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

{Binding} se ilustra con la sintaxis de marcador de posición bindingProperties porque hay varias propiedades de lectura y escritura de un enlace que se puede establecer en la extensión de marcado. Las propiedades se pueden establecer en cualquier orden con pares de valores propName=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}.

Nota Si vas a convertir el marcado de {x:Bind} a {Binding}, ten en cuenta las diferencias en los valores predeterminados de la propiedad Mode .

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.

Sugerencia Si necesita especificar una sola llave para un valor, como en Path o ConverterParameter, preceda a una barra diagonal inversa: . \{ Como alternativa, incluya toda la cadena que contiene las llaves que necesitan escape en un conjunto de comillas secundarias, por ejemplo ConverterParameter='{Mix}'.

Ejemplos

<!-- 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. La ruta de acceso en este caso se muestra explícitamente denominada como una propiedad Binding . La ruta de acceso 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í. La interna se evalúa primero, por lo que una vez que se obtiene el recurso, hay un IValueConverter práctico (una clase personalizada creada por el local:S2Formatter elemento en recursos) que el enlace 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 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.