다음을 통해 공유


DependencyObject.SetValue(DependencyProperty, Object) 메서드

정의

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를 호출하는 것이 더 간단할 수 있습니다.

적용 대상

추가 정보