DependencyObject.SetValue(DependencyProperty, Object) 메서드

정의

네임스페이스:

Microsoft.UI.Xaml

DependencyObject에서 종속성 속성의 로컬 값을 설정합니다.

public:
 virtual void SetValue(DependencyProperty ^ dp, Platform::Object ^ value) = SetValue;

void SetValue(DependencyProperty const& dp, IInspectable const& value);

public void SetValue(DependencyProperty dp, object value);

function setValue(dp, value)

Public Sub SetValue (dp As DependencyProperty, value As Object)

매개 변수

dp

DependencyProperty

설정할 종속성 속성의 식별자입니다.

value

Object

Platform::Object

IInspectable

새 로컬 값입니다.

설명

제공된 값 형식이 원래 등록된 종속성 속성에 대해 선언된 형식과 일치하지 않으면 예외가 throw됩니다.

XAML에서 사용하는 모든 Windows 런타임 속성이 종속성 속성은 아닙니다. DependencyProperty 식별자가 있어야 하며 소유 개체의 공용 속성(일반적으로 속성을 등록한 개체)으로 사용할 수 있어야 합니다.

앱 사용자 코드의 경우 일반적으로 호출 SetValue 이 필요하지 않습니다. 일반적으로 Windows 런타임 종속성 속성 또는 사용자 지정 종속성 속성에는 래핑하는 기존 속성이 있으며 기존 점선 사용을 통해 속성 값을 설정할 수 있습니다. 계속 사용할 SetValue 수 있는 경우는 다음과 같습니다.

• 사용자 지정 종속성 속성을 정의하고 있습니다. 를 기존 속성 사용에 대한 고유한 속성 집합 접근자 정의의 일부로 호출 SetValue 합니다. 자세한 내용은 사용자 지정 종속성 속성을 참조하세요.
• 콜백을 정의하거나 DependencyProperty 식별자를 이미 전달하고 있는 다른 scope 있으며, 해당 scope 상호 작용할 수 있는 종속성 속성이 둘 이상 있을 수 있습니다. 이러한 경우 를 호출 SetValue하는 것이 더 간단할 수 있으며 식별자를 전달합니다.

추가 정보

• 사용자 지정 종속성 속성
• 종속성 속성 개요
• XAML 사용자 및 사용자 지정 컨트롤 샘플