Extensión de marcado {Binding}

La extensión de marcado {Binding} se usa para enlazar propiedades en controles a valores procedentes de un origen de datos, como de código. El {Binding} se convierte durante la carga de XAML en una instancia de la clase Binding de . 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 transferir cambios en el valor de control de nuevo a 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 Información general sobre 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 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

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

El tipo de ruta es una ruta de propiedad, que es una cadena que se evalúa como una propiedad o una subpropiedad del tipo personalizado o de un tipo de framework. El tipo puede ser un DependencyObject, pero no es necesario que lo sea. Los pasos de una ruta de acceso de propiedad se delimitan por puntos (.) y se pueden 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 del nombre de pila de un objeto Employee, la ruta de acceso de la propiedad podría ser "Employee.FirstName". 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 elemento del control de elementos 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 "[]" encierra el "0" que especifica el primer elemento de una colección.

Al utilizar un enlace ElementName a un DependencyObject existente, puedes 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 tendrán que 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 propiedad en áreas de características de animación y la construcción de un objeto PropertyPath, consulta Sintaxis de ruta de acceso de propiedades .

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 Binding que se pueden establecer en la extensión de marcado. Las propiedades se pueden establecer en cualquier orden con pares de propName=valor, 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 la {Binding}.

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 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" de Vinculación de datos en profundidad.

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

Sugerencia Si necesita especificar una sola llave para un valor, como en Ruta de acceso o ConverterParameter, preceda a una barra invertida: \{. Como alternativa, coloque entre comillas secundarias toda la cadena que contiene los corchetes que deben ser escapados, 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. Path en este caso se muestra explícitamente denominado como una propiedad Binding . El camino 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 deslizador denominado sliderValueConverter.

Tenga en cuenta cómo el valor de la propiedad Converter utiliza otra extensión de marcado, la extensión de marcado {StaticResource}, por lo que hay dos usos de extensiones de marcado anidadas aquí. Primero se evalúa el interno, por lo que una vez que se obtiene el recurso, hay un práctico IValueConverter (una clase personalizada creada por el elemento local:S2Formatter en los 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. Tan pronto como escriba "{Binding", las propiedades de contexto de datos apropiadas para se muestran en el desplegable. IntelliSense también ayuda con las otras propiedades de Binding. Para que esto funcione, debe tener configurado ya sea el contexto de datos o el contexto de datos en tiempo de diseño en la página de marcado. Ir a la definición (F12) también funciona con {Binding}. Como alternativa, puede usar el cuadro de diálogo de enlace de datos.