FrameworkContentElement.SetBinding Метод

Определение

Присоединяет привязку к этому элементу для указанного свойства зависимостей.Attaches a binding to this element for the specified dependency property.

Перегрузки

SetBinding(DependencyProperty, String)

Прикрепляет привязку к данному элементу на основе указанного имени исходного свойства в виде классификационного пути к источнику данных.Attaches a binding to this element, based on the provided source property name as a path qualification to the data source.

SetBinding(DependencyProperty, BindingBase)

Прикрепляет привязку к данному элементу на основе предоставленной привязки объекта.Attaches a binding to this element, based on the provided binding object.

SetBinding(DependencyProperty, String)

Прикрепляет привязку к данному элементу на основе указанного имени исходного свойства в виде классификационного пути к источнику данных.Attaches a binding to this element, based on the provided source property name as a path qualification to the data source.

public:
 System::Windows::Data::BindingExpression ^ SetBinding(System::Windows::DependencyProperty ^ dp, System::String ^ path);
public System.Windows.Data.BindingExpression SetBinding (System.Windows.DependencyProperty dp, string path);
member this.SetBinding : System.Windows.DependencyProperty * string -> System.Windows.Data.BindingExpression
Public Function SetBinding (dp As DependencyProperty, path As String) As BindingExpression

Параметры

dp
DependencyProperty

Идентифицирует привязанное свойство.Identifies the bound property.

path
String

Имя исходного свойства или путь к свойству, используемому для привязки.The source property name or the path to the property used for the binding.

Возвраты

Фиксирует состояния привязки.Records the conditions of the binding. Это возвращаемое значение можно использовать для проверки ошибок.This return value can be useful for error checking.

Примеры

В следующем примере задается привязка для элемента Paragraph, создавая новый пользовательский объект данных, устанавливая этот объект как DataContextи настроив путь привязки на свойство в нем.The following example sets a binding on a Paragraph element, by creating a new custom data object, establishing that object as DataContext, and setting the binding path to a property within it.

MyData myDataObject = new MyData();
myflowdocument.DataContext = myDataObject;
introParagraph.SetBinding(Paragraph.TagProperty, "CustomData");
Dim myDataObject As New MyData()
myflowdocument.DataContext = myDataObject
introParagraph.SetBinding(Paragraph.TagProperty, "CustomData")

Комментарии

Этот метод является удобным методом для вызова BindingOperations.SetBinding, который передает текущий экземпляр в качестве DependencyObjectи создает новый Binding на основе предоставленного параметра path.This method is a convenience method for calling BindingOperations.SetBinding, which passes the current instance as the DependencyObject, and creates a new Binding based on the provided path parameter. Эта сигнатура удобнее, если вы устанавливаете простую привязку по умолчанию.This signature is more convenient if you are establishing a simple default binding. Если необходимо указать какие-либо свойства привязки для условий, отличных от Default, или использовать MultiBinding или PriorityBinding, следует использовать сигнатуру SetBinding(DependencyProperty, BindingBase).If you need to specify any binding properties to non-default conditions, or want to use a MultiBinding or PriorityBinding,you should use the SetBinding(DependencyProperty, BindingBase) signature.

SetBinding(DependencyProperty, BindingBase)

Прикрепляет привязку к данному элементу на основе предоставленной привязки объекта.Attaches a binding to this element, based on the provided binding object.

public:
 System::Windows::Data::BindingExpressionBase ^ SetBinding(System::Windows::DependencyProperty ^ dp, System::Windows::Data::BindingBase ^ binding);
public System.Windows.Data.BindingExpressionBase SetBinding (System.Windows.DependencyProperty dp, System.Windows.Data.BindingBase binding);
member this.SetBinding : System.Windows.DependencyProperty * System.Windows.Data.BindingBase -> System.Windows.Data.BindingExpressionBase
Public Function SetBinding (dp As DependencyProperty, binding As BindingBase) As BindingExpressionBase

Параметры

dp
DependencyProperty

Идентифицирует привязанное свойство.Identifies the bound property.

binding
BindingBase

Представляет привязку данных.Represents a data binding.

Возвраты

Фиксирует состояния привязки.Records the conditions of the binding. Это возвращаемое значение можно использовать для проверки ошибок.This return value can be useful for error checking.

Примеры

В следующем примере задается привязка для элемента Paragraph путем создания нового Binding и присвоения источнику вновь созданного DateTime объекта.The following example sets a binding on a Paragraph element, by creating a new Binding and setting the source to a newly built DateTime object.

DateTime myDataObject = new DateTime();
Binding myBinding = new Binding();
myBinding.Source = myDataObject;
introParagraph.SetBinding(Paragraph.TagProperty, myBinding);
Dim myDataObject As New Date()
Dim myBinding As New Binding()
myBinding.Source = myDataObject
introParagraph.SetBinding(Paragraph.TagProperty, myBinding)

Комментарии

Этот метод является удобным методом для вызова BindingOperations.SetBinding, который передает текущий экземпляр в качестве DependencyObject.This method is a convenience method for calling BindingOperations.SetBinding, which passes the current instance as the DependencyObject.

Применяется к