DependencyObject.SetValue 메서드

정의

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

오버로드

SetValue(DependencyProperty, Object)

지정된 종속성 속성 식별자를 가진 종속성 속성의 로컬 값을 설정합니다.

SetValue(DependencyPropertyKey, Object)

종속성 속성의 DependencyPropertyKey 식별자에 의해 지정된 읽기 전용 종속성 속성의 로컬 값을 설정합니다.

SetValue(DependencyProperty, Object)

지정된 종속성 속성 식별자를 가진 종속성 속성의 로컬 값을 설정합니다.

public:
 void SetValue(System::Windows::DependencyProperty ^ dp, System::Object ^ value);
public void SetValue (System.Windows.DependencyProperty dp, object value);
member this.SetValue : System.Windows.DependencyProperty * obj -> unit
Public Sub SetValue (dp As DependencyProperty, value As Object)

매개 변수

dp
DependencyProperty

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

value
Object

새 로컬 값입니다.

예외

읽기 전용 종속성 속성 또는 봉인된 DependencyObject의 속성을 수정하려고 했습니다.

valuedp 속성에 대해 등록된 올바른 형식이 아닙니다.

설명

제공된 형식이 원래 등록된 종속성 속성에 대해 선언된 형식과 일치하지 않으면 예외가 throw됩니다. 매개 변수는 value 항상 적절한 형식으로 제공되어야 합니다.

예외 조건은 설정 중인 종속성 속성의 ValidateValueCallback 종속성 속성 식별자에 있는 콜백의 영향을 받습니다. 그렇지 않으면 제공된 값이 일반적인 형식 검사 조건에 실패할 수 있습니다(예: 네이티브 형식이 Double인 경우 문자열 전달).

적용 대상

SetValue(DependencyPropertyKey, Object)

종속성 속성의 DependencyPropertyKey 식별자에 의해 지정된 읽기 전용 종속성 속성의 로컬 값을 설정합니다.

public:
 void SetValue(System::Windows::DependencyPropertyKey ^ key, System::Object ^ value);
public void SetValue (System.Windows.DependencyPropertyKey key, object value);
member this.SetValue : System.Windows.DependencyPropertyKey * obj -> unit
Public Sub SetValue (key As DependencyPropertyKey, value As Object)

매개 변수

key
DependencyPropertyKey

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

value
Object

새 로컬 값입니다.

예제

다음 예제에서는 속성 소비자에게 필요한 읽기 전용 노출을 제공하는 과 CLR 래퍼에 대한 get 접근자를 제공하는 와 함께 public static readonlyDependencyProperty 읽기 전용 종속성 속성을 정의합니다.

internal static readonly DependencyPropertyKey AquariumSizeKey = DependencyProperty.RegisterReadOnly(
  "AquariumSize",
  typeof(double),
  typeof(Aquarium),
  new PropertyMetadata(double.NaN)
);
public static readonly DependencyProperty AquariumSizeProperty =
  AquariumSizeKey.DependencyProperty;
public double AquariumSize
{
  get { return (double)GetValue(AquariumSizeProperty); }
}
Friend Shared ReadOnly AquariumSizeKey As DependencyPropertyKey = DependencyProperty.RegisterReadOnly("AquariumSize", GetType(Double), GetType(Aquarium), New PropertyMetadata(Double.NaN))
Public Shared ReadOnly AquariumSizeProperty As DependencyProperty = AquariumSizeKey.DependencyProperty
Public ReadOnly Property AquariumSize() As Double
    Get
        Return CDbl(GetValue(AquariumSizeProperty))
    End Get
End Property

설명

이 서명은 일반적으로 사용자 지정 클래스에서 정의한 읽기 전용 종속성 속성에 대한 값을 설정할 때 사용됩니다. 일반적으로 는 SetValue 종속성 속성에 대해 결정된 값을 제공하는 내부 논리를 구현하는 해당 종속성 속성을 등록한 형식에서만 호출됩니다. 자세한 내용은 읽기 전용 종속성 속성을 참조하세요.

제공된 형식이 원래 등록된 종속성 속성에 대해 선언된 형식과 일치하지 않으면 예외가 throw됩니다. 매개 변수는 value 항상 적절한 형식으로 제공되어야 합니다. 예외 조건은 설정 중인 종속성 속성의 ValidateValueCallback 종속성 속성 식별자에 있는 콜백의 영향을 받습니다.

적용 대상