DependencyObject.SetValue 메서드

정의

종속성 속성의 로컬 값을 설정합니다.Sets the local value of a dependency property.

오버로드

SetValue(DependencyProperty, Object)

지정된 종속성 속성 식별자를 가진 종속성 속성의 로컬 값을 설정합니다.Sets the local value of a dependency property, specified by its dependency property identifier.

SetValue(DependencyPropertyKey, Object)

종속성 속성의 DependencyPropertyKey 식별자에 의해 지정된 읽기 전용 종속성 속성의 로컬 값을 설정합니다.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

SetValue(DependencyProperty, Object)

지정된 종속성 속성 식별자를 가진 종속성 속성의 로컬 값을 설정합니다.Sets the local value of a dependency property, specified by its dependency property identifier.

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

설정할 종속성 속성의 식별자입니다.The identifier of the dependency property to set.

value
Object

새 로컬 값입니다.The new local value.

예외

읽기 전용 종속성 속성 또는 봉인된 DependencyObject의 속성을 수정하려고 한 경우Attempted to modify a read-only dependency property, or a property on a sealed DependencyObject.

valuedp 속성에 대해 등록된 올바른 형식이 아닌 경우value was not the correct type as registered for the dp property.

설명

제공된 된 형식에는 처음에 등록 된 종속성 속성의 선언 된 형식을 일치 하지 않으면, 예외가 throw 됩니다.If the provided type does not match the type that is declared for the dependency property as it was originally registered, an exception is thrown. value 매개 변수는 항상 적절 한 형식으로 제공 되어야 합니다.The value parameter should always be provided as the appropriate type.

예외 조건에 잠재적으로 영향을 받지는 ValidateValueCallback 설정 되는 종속성 속성의 종속성 속성 식별자에 있는 콜백 합니다.The exception conditions are potentially influenced by the ValidateValueCallback callback that exists on the dependency property identifier of the dependency property being set. 그렇지 않으면 제공 된 값에는 일반 형식 검사 조건 (예: 네이티브 형식이 Double 인 경우 문자열을 전달) 실패할 수 있습니다.Otherwise, the value provided might be failing general type-checking conditions (for example, passing a string when the native type is Double).

SetValue(DependencyPropertyKey, Object)

종속성 속성의 DependencyPropertyKey 식별자에 의해 지정된 읽기 전용 종속성 속성의 로컬 값을 설정합니다.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

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 식별자입니다.The DependencyPropertyKey identifier of the property to set.

value
Object

새 로컬 값입니다.The new local value.

예제

다음 예제와 함께 읽기 전용 종속성 속성을 정의 public static readonly DependencyProperty 필요한 읽기 전용으로 노출 속성 소비자에 대 한 get 접근자를 제공 하는 CLRCLR 래퍼입니다.The following example defines a read-only dependency property, along with a public static readonly DependencyProperty that provides necessary read-only exposure to property consumers, and the get accessor for the CLRCLR wrapper.

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

설명

사용자 지정 클래스에서 정의 된 읽기 전용 종속성 속성에 대 한 값을 설정할 때 일반적으로이 서명이 됩니다.This signature is generally used when you set values for read-only dependency properties that are defined by your custom classes. 일반적으로 SetValue 종속성 속성에 대해 결정된 된 값을 제공 하는 내부 논리를 구현 하는 종속성 속성에 등록 하는 형식 에서만에서 호출 됩니다.Generally, SetValue is called only from the type that registered that dependency property, which implements the internal logic that provides the determined value for the dependency property. 자세한 내용은 읽기 전용 종속성 속성을 참조하세요.For more information, see Read-Only Dependency Properties.

제공된 된 형식에는 처음에 등록 된 종속성 속성의 선언 된 형식을 일치 하지 않으면, 예외가 throw 됩니다.If the provided type does not match the type that is declared for the dependency property as it was originally registered, an exception is thrown. value 매개 변수는 항상 적절 한 형식으로 제공 되어야 합니다.The value parameter should always be provided as the appropriate type. 예외 조건에 잠재적으로 영향을 받지는 ValidateValueCallback 설정 되는 종속성 속성의 종속성 속성 식별자에 있는 콜백 합니다.The exception conditions are potentially influenced by the ValidateValueCallback callback that exists on the dependency property identifier of the dependency property being set.

적용 대상