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 속성 소비자에 필요한 읽기 전용 노출을 제공 하는와 함께 읽기 전용 종속성 속성 및 CLR 래퍼에 대 한 get 접근자를 정의 합니다.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 CLR 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.

적용 대상