Extensión de marcado {Binding}

Nota:

Hay disponible un nuevo mecanismo de enlace para Windows 10, que está optimizado para la productividad del desarrollador y el rendimiento. Consulte la extensión de marcado {x:Bind}.

Nota

Para obtener información general sobre el uso del enlace de datos en la aplicación con {Binding} (y para obtener una comparación completa entre {x:Bind} y {Binding}), consulta Enlace de datos en profundidad.

La extensión de marcado {Binding} se usa para enlazar datos propiedades 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 propiedad en un origen de datos y lo inserta en la propiedad que está en el control. Opcionalmente, el objeto de enlace puede configurarse para observar cambios en el valor de la propiedad de origen de datos y se actualiza en función de dichos cambios. Opcionalmente, también puede configurarse para insertar los cambios en el valor del 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, consulta Introducción a las propiedades de dependencia.

{Binding} tiene la misma prioridad 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 del atributo XAML

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

Término	Descripción
propertyPath	Una cadena que especifica la ruta de acceso de la propiedad para el enlace. Para obtener más información, consulta la sección Ruta de acceso de propiedades que aparece más adelante.
bindingProperties	propName=value[, propName=value]* Una o más propiedades de enlace que se especifican con una sintaxis de par de nombre-valor.
propName	Nombre de cadena de la propiedad que se va a establecer en el objeto Binding . Por ejemplo, "Converter".
value	El valor en el que se establecerá la propiedad. La sintaxis del argumento depende de la propiedad de la sección Propiedades de la clase Binding que se pueden establecer con {Binding} que aparece más adelante.

Ruta de acceso de la propiedad

Path describe la propiedad que estás enlazando (la propiedad de origen). Path es un parámetro de posición, lo que significa que puedes usar el nombre del parámetro explícitamente ({Binding Path=EmployeeID}), o bien, 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 subpropiedad de su tipo personalizado o de un tipo de marco. El tipo puede ser (pero no tiene por qué serlo) un DependencyObject. Los pasos de las rutas de acceso de propiedad están delimitados por puntos (.) y puedes incluir varios delimitadores para desviar subpropiedades sucesivas. Usa puntos como delimitadores independientemente del lenguaje de programación que uses para implementar el objeto al que se está enlazando.

Por ejemplo, para enlazar la interfaz de usuario a la propiedad del nombre de un objeto de un empleado, tu ruta de acceso de propiedad podría ser "Employee.FirstName". Si estás enlazando un control de elemento a una propiedad que contiene las personas a cargo del empleado, la ruta de acceso de la propiedad podría ser "Employee.Dependents" y la plantilla del elemento del control de elementos se ocuparía de mostrar los elementos en "Dependents".

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

Al usar un enlace ElementName para un DependencyObject existente, puedes usar propiedades adjuntas como parte de la ruta de acceso de la propiedad. Para desambiguar una propiedad adjunta de manera que el punto intermedio en el nombre de la propiedad adjunta no se considere un paso dentro de la ruta de acceso de la propiedad, coloca paréntesis alrededor del nombre de la 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 en la mayoría de escenarios no es necesario interactuar con un objeto PropertyPath en el código. Normalmente puedes especificar la información de enlace necesaria mediante XAML.

Para obtener más información sobre la sintaxis de cadenas de una ruta de acceso de propiedades, rutas de acceso de propiedades en áreas de características de animaciones y la construcción de un objeto PropertyPath, consulta Sintaxis de Property-path.

Propiedades de la clase de enlace que se pueden establecer con {Binding}

{Binding} se explica a través de la sintaxis de marcadores de posición bindingProperties porque hay muchas propiedades de lectura y escritura de Binding que se pueden definir en la extensión de marcado. Las propiedades se pueden establecer en cualquier orden con pares devalorpropName= separados por comas. Algunas de las propiedades requieren tipos que no tengan una conversión de tipos, por lo que requieren sus propias extensiones de marcado anidadas dentro de {Binding}.

Propiedad	Descripción
Ruta de acceso	Consulta la sección Ruta de acceso de propiedades anteriormente.
Converter	Especifica un objeto convertidor al que el motor de enlace llama. El convertidor puede establecerse en el marcado mediante la extensión de marcado {StaticResource} para hacer referencia a ese objeto desde un diccionario de recursos.
ConverterLanguage	Especifica la referencia cultural que usará el convertidor. (Si estableces Converter). La cultura se establece como un identificador basado en estándares. Para obtener más información, consulta ConverterLanguage.
ConverterParameter	Especifica un parámetro del convertidor que se puede usar en la lógica del convertidor. (Si estableces Converter). La mayoría de convertidores usan una lógica simple que obtiene toda la información que necesitan del valor pasado para convertir y no necesitan ningún valor de ConverterParameter. El parámetro ConverterParameter es para las implementaciones de convertidor más complejas, que disponen de una lógica condicional que controla lo que se pasa en ConverterParameter. Puedes escribir un convertidor que use valores que no sean cadenas, aunque no es lo habitual. Consulta las observaciones de ConverterParameter para obtener más información.
ElementName	Especifica un origen de datos haciendo referencia a otro elemento en la misma construcción XAML que tenga la propiedad Name o el atributo x:Name. A menudo, se usa para compartir valores relacionados o usar subpropiedades de un elemento de interfaz de usuario para proporcionar un valor específico para otro elemento, por ejemplo, en una plantilla de control XAML.
FallbackValue	Especifica un valor que se mostrará cuando no se pueda resolver el origen o la ruta de acceso.
Modo	Especifica el modo de enlace como uno de los siguientes valores: "OneTime", "OneWay" o "TwoWay". Estos se corresponden con los nombres de constante de la enumeración de BindingMode. El valor predeterminado es "OneWay". Ten en cuenta que esto difiere del valor predeterminado de {x:Bind}, que es "OneTime".
RelativeSource	Para especificar un origen de datos, describe la posición del origen del enlace con relación a la posición del destino de enlace. Esto suele usarse en los enlaces dentro de plantillas de control XAML, estableciendo la extensión de marcado {RelativeSource}.
Source	Especifica el origen de datos del objeto. Dentro de la extensión de marcado Binding, la propiedad Source requiere una referencia de objeto, como una referencia de extensión de marcado {StaticResource}. Si no se especifica esta propiedad, el contexto de datos que actúa especifica el origen. Es más habitual no especificar un valor Source en enlaces individuales y, en lugar de ello, basarse en la propiedad DataContext compartida para enlaces múltiples. Para más información, consulta DataContext o Enlace de datos en profundidad.
TargetNullValue	Especifica el valor que se mostrará cuando se resuelva el valor de origen, pero es explícitamente null.
UpdateSourceTrigger	Especifica el tiempo de las actualizaciones de origen de enlace. Si no se especifica, el valor predeterminado es Default.

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

Converter, ConverterLanguage y ConverterLanguage tienen relación con la conversión de un valor o tipo del origen de enlace en un valor o tipo que sea compatible con la propiedad de destino de enlace. Para obtener más información y ejemplos, consulta la sección “Conversiones de datos” de Enlaces de datos en profundidad.

Nota:

A partir de la versión 1607 de Windows 10, el marco XAML proporciona un valor booleano integrado para el convertidor Visibility. El convertidor se asigna true al valor de enumeración Visible y false a Collapsed para que pueda enlazar una propiedad Visibility a un valor booleano sin crear un convertidor. Para usar el convertidor integrado, la versión mínima del SDK de destino de la aplicación debe ser 14393 o posterior. No puedes usarlo si la aplicación está destinada a versiones anteriores de Windows 10. Para obtener más información sobre las versiones de destino, consulta Version adaptive code (Código adaptativo para versiones).

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

Propina Si necesita especificar una sola llave para un valor, como en Path o ConverterParameter, precedítelo con una barra diagonal inversa: \{. Como alternativa, escribe la cadena completa que contiene las llaves que necesitan escape entre un conjunto de comillas secundario, 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>

El segundo ejemplo establece cuatro propiedades de Binding distintas: ElementName, Path, Mode y Converter. Path en este caso se muestra explícitamente como una propiedad Binding. Path se evalúa en un origen de enlace de datos que es otro objeto del mismo árbol de objetos en tiempo de ejecución, un Slider denominado sliderValueConverter.

Observa que el valor de la propiedad Converter usa otra extensión de marcado, extensión de marcado {StaticResource}, de forma que hay dos usos de extensiones de marcado anidadas. La interior se evalúa primero de tal forma que, una vez obtenido el recurso, hay un IValueConverter práctico (una clase personalizada de la cual el elemento local:S2Formatter de los recursos crea una instancia) que puede usarse en el enlace.

Compatibilidad con herramientas

Microsoft IntelliSense en Microsoft Visual Studio muestra las propiedades del contexto de datos durante la creación de {Binding} en el editor de marcado XAML. Tan pronto como escribes "{Binding", se muestran las propiedades de contexto de datos adecuadas para Path en la lista desplegable. IntelliSense también ayuda con las otras propiedades de Binding. Para que funcione, debes 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, puedes usar el cuadro de diálogo de enlace de datos.