FrameworkElement.SetBinding(DependencyProperty, BindingBase) 메서드

정의

네임스페이스:

Windows.UI.Xaml

제공된 바인딩 개체를 사용하여 FrameworkElement에 바인딩을 연결합니다.

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)

매개 변수

dp

DependencyProperty

데이터에 바인딩된 속성의 종속성 속성 식별자입니다.

binding

BindingBase

속성에 사용할 바인딩입니다.

예제

다음은 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);

'Create the source string 
Dim s As String = "Hello"

'Create the binding description 
Dim b As New Binding()
b.Mode = BindingMode.OneTime
b.Source = s

'Attach the binding to the target 
Dim MyText As New TextBlock()
MyText.SetBinding(TextBlock.TextProperty, b)

설명

이 메서드는 BindingOperations.SetBinding을 호출하여 현재 instance 대상 매개 변수로 전달하는 편리한 메서드입니다.

바인딩 매개 변수의 형식은 호환성을 위해 BindingBase이지만 Windows 런타임 항상 Binding instance 전달합니다. 바인딩 은 BindingBase에서 파생됩니다.

dp 매개 변수는 종속성 속성 식별자를 사용합니다. 종속성 속성 및 DependencyProperty 값이 식별자로 사용되는 방법에 대한 자세한 내용은 종속성 속성 개요를 참조하세요.

사용자 지정 종속성 속성 또는 사용자 지정 연결된 속성에 바인딩할 수 있습니다. dp 매개 변수로 전달하는 식별자는 Windows 런타임 정의된 속성일 필요가 없습니다.

코드에서 만든 바인딩이 동작 데이터 컨텍스트를 사용할 수 있는지 여부는 개체 수명 고려 사항에 따라 달라집니다. 예를 들어 XAML에서 설정된 DataContext 값은 XAML을 구문 분석할 때까지 사용할 수 없습니다. 이 경우 로드된 처리기를 사용하여 코드에서 바인딩을 추가할 수 있습니다.

참고

SetBinding 메서드를 호출하고 새 Binding 개체를 전달해도 기존 바인딩이 반드시 제거되는 것은 아닙니다. 대신 먼저 DependencyObject.ClearValue 메서드를 호출한 다음 SetBinding을 호출해야 합니다.

연결된 속성에 바인딩

대상 개체가 지원하는 연결된 속성에 데이터 바인딩을 배치할 수 있습니다. 기술적으로 DependencyObject 는 가능한 모든 연결된 속성을 지원하지만 일반적으로 해당 개체 또는 시나리오와 관련된 연결된 속성에 대해서만 바인딩을 설정합니다. 예를 들어 대상 요소에 해당 정보를 사용할 Grid 부모가 있다고 예상하는 경우에만 Grid.Row에 바인딩을 설정합니다. dp 매개 변수를 연결된 속성의 소유자 클래스에 있는 종속성 속성 식별자로 지정합니다(Grid.Row 예제의 경우 식별자는 Grid.RowProperty임). 연결된 속성이므로 대상에서 해당 식별자를 찾을 수 없습니다. 연결된 속성에 대한 자세한 내용은 연결된 속성 개요를 참조하세요.

추가 정보

• Binding
• BindingOperations
• 데이터 바인딩 심층 분석
• 종속성 속성 개요