FrameworkContentElement.SetBinding Metoda

Definicja

Dołącza powiązanie do tego elementu dla określonej właściwości zależności.Attaches a binding to this element for the specified dependency property.

Przeciążenia

SetBinding(DependencyProperty, String)

Dołącza powiązanie do tego elementu, na podstawie podanej nazwy właściwości źródłowej jako ścieżki kwalifikacji do źródła danych.Attaches a binding to this element, based on the provided source property name as a path qualification to the data source.

SetBinding(DependencyProperty, BindingBase)

Dołącza powiązanie do tego elementu na podstawie podanego obiektu powiązania.Attaches a binding to this element, based on the provided binding object.

SetBinding(DependencyProperty, String)

Dołącza powiązanie do tego elementu, na podstawie podanej nazwy właściwości źródłowej jako ścieżki kwalifikacji do źródła danych.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

Parametry

dp
DependencyProperty

Identyfikuje właściwość powiązaną.Identifies the bound property.

path
String

Nazwa właściwości źródłowej lub ścieżka do właściwości użytej dla powiązania.The source property name or the path to the property used for the binding.

Zwraca

Rejestruje warunki powiązania.Records the conditions of the binding. Ta wartość zwracana może być przydatna do sprawdzania błędów.This return value can be useful for error checking.

Przykłady

Poniższy przykład ustawia powiązanie dla elementu Paragraph, tworząc nowy obiekt danych niestandardowych, ustanawiając ten obiekt jako DataContexti ustawiając ścieżkę powiązania do właściwości w tym elemencie.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")

Uwagi

Ta metoda jest wygodną metodą wywoływania BindingOperations.SetBinding, która przekazuje bieżące wystąpienie jako DependencyObject, i tworzy nowy Binding na podstawie podanego parametru 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. Ten podpis jest wygodniejszy, jeśli tworzysz proste domyślne powiązanie.This signature is more convenient if you are establishing a simple default binding. Jeśli musisz określić dowolne właściwości powiązania z warunkami niedomyślnymi lub chcesz użyć MultiBinding lub PriorityBinding, należy użyć podpisu 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)

Dołącza powiązanie do tego elementu na podstawie podanego obiektu powiązania.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

Parametry

dp
DependencyProperty

Identyfikuje właściwość powiązaną.Identifies the bound property.

binding
BindingBase

Reprezentuje powiązanie danych.Represents a data binding.

Zwraca

Rejestruje warunki powiązania.Records the conditions of the binding. Ta wartość zwracana może być przydatna do sprawdzania błędów.This return value can be useful for error checking.

Przykłady

Poniższy przykład ustawia powiązanie dla elementu Paragraph, tworząc nowe Binding i ustawiając Źródło dla nowo skompilowanego obiektu 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)

Uwagi

Ta metoda jest wygodną metodą wywołania BindingOperations.SetBinding, która przekazuje bieżące wystąpienie jako DependencyObject.This method is a convenience method for calling BindingOperations.SetBinding, which passes the current instance as the DependencyObject.

Dotyczy