DependencyObject.SetValue 메서드

정의

네임스페이스:

System.Windows

어셈블리:

WindowsBase.dll

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

오버로드

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

새 로컬 값입니다.

예외

InvalidOperationException

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

ArgumentException

value dp 속성에 등록된 올바른 형식이 아닙니다.

설명

제공된 형식이 원래 등록된 종속성 속성에 대해 선언된 형식과 일치하지 않으면 예외가 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

새 로컬 값입니다.

예제

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

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 종속성 속성에 대해 결정된 값을 제공하는 내부 논리를 구현하는 해당 종속성 속성을 등록한 형식에서만 호출됩니다. 자세한 내용은 Read-Only 종속성 속성참조하세요.

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