FrameworkElement.SetBinding(DependencyProperty, BindingBase) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Asocia un enlace a un FrameworkElement mediante el objeto de enlace proporcionado.
void SetBinding(DependencyProperty const& dp, BindingBase const& binding);public void SetBinding(DependencyProperty dp, BindingBase binding);function setBinding(dp, binding)Public Sub SetBinding (dp As DependencyProperty, binding As BindingBase)Parámetros
Identificador de propiedad de dependencia de la propiedad enlazada a datos.
- binding
- BindingBase
Enlace que se va a usar para la propiedad .
Ejemplos
En este ejemplo se establece un enlace a una propiedad de dependencia en un objeto mediante una llamada a SetBinding.
// 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.
TextBlock MyText = new TextBlock();
MyText.SetBinding(TextBlock.TextProperty, b);
Comentarios
Este método es un método práctico que llama a BindingOperations.SetBinding, pasando la instancia actual como el target parámetro .
El tipo del binding parámetro es BindingBase por motivos de compatibilidad, pero en el Windows Runtime siempre se pasa una instancia de Binding. La clase Binding se deriva de la clase BindingBase.
El dp parámetro toma un identificador de propiedad de dependencia. Para obtener más información sobre las propiedades de dependencia y cómo un valor DependencyProperty actúa como identificador, consulte Información general sobre las propiedades de dependencia.
Puede enlazar a propiedades de dependencia personalizadas o propiedades adjuntas personalizadas, el identificador que se pasa como el dp parámetro no tiene que ser una propiedad definida Windows Runtime.
Si un enlace creado a partir del código podrá usar un contexto de datos que actúe depende de las consideraciones de duración del objeto. Por ejemplo, un valor DataContext que se establece desde XAML no estará disponible hasta que se analice el CÓDIGO XAML. En ese caso, es posible que desee usar un controlador cargado para agregar enlaces desde el código.
Nota
Llamar al SetBinding método y pasar un nuevo objeto Binding no eliminará necesariamente un enlace existente. En su lugar, primero debe llamar al método DependencyObject.ClearValue y, a continuación, llamar a SetBinding.
Enlace a propiedades adjuntas
Puede colocar enlaces de datos en las propiedades adjuntas que admita un objeto de destino. Técnicamente, un DependencyObject admite todas las propiedades adjuntas posibles, pero normalmente solo establecería un enlace en una propiedad adjunta relevante para ese objeto o escenario. Por ejemplo, establecería un enlace en Grid.Row solo si prevé que el elemento de destino tiene un elemento primario Grid que usará esa información. Especifique el parámetro dp como identificador de propiedad de dependencia que existe en la clase de propietario de la propiedad adjunta (por Grid.Row ejemplo, ese identificador es Grid.RowProperty). No encontrará ese identificador en el destino porque es una propiedad adjunta. Para obtener más información sobre las propiedades adjuntas, consulta Información general sobre las propiedades adjuntas.