DependencyObject.CoerceValue(DependencyProperty) 메서드

정의

지정된 종속성 속성의 값을 강제 변환합니다.Coerces the value of the specified dependency property. 호출하는 DependencyObject에 있으므로 이 작업은 종속성 속성의 속성 메타데이터에 지정된 CoerceValueCallback 함수를 호출하여 수행합니다.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

public:
 void CoerceValue(System::Windows::DependencyProperty ^ dp);
public void CoerceValue (System.Windows.DependencyProperty dp);
member this.CoerceValue : System.Windows.DependencyProperty -> unit
Public Sub CoerceValue (dp As DependencyProperty)

매개 변수

dp
DependencyProperty

강제 변환할 종속성 속성의 식별자입니다.The identifier for the dependency property to coerce.

예외

지정된 dp 또는 해당 값이 잘못되었거나 존재하지 않습니다.The specified dp or its value were invalid or do not exist.

예제

다음 예제에서는 CoerceValue 내에서 한 PropertyChangedCallback 구현으로 사용 되는 PropertyChangedCallback 같은 클래스에는 서로 다른 종속성 속성에 대 한 합니다.The following example calls CoerceValue within a PropertyChangedCallback implementation that is used as the PropertyChangedCallback for a different dependency properties on the same class. 종속성 속성 간에 종속성 true 값을 소개 하는 것에 대 한 일반적인 패턴입니다.This is a common pattern for introducing true value dependencies between dependency properties.

private static void OnCurrentReadingChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
{
  d.CoerceValue(MinReadingProperty);
  d.CoerceValue(MaxReadingProperty);
}
Private Shared Sub OnCurrentReadingChanged(ByVal d As DependencyObject, ByVal e As DependencyPropertyChangedEventArgs)
    d.CoerceValue(MinReadingProperty)
    d.CoerceValue(MaxReadingProperty)
End Sub

설명

호출을 통해 명시적으로 호출 되는 것 외에도 CoerceValueCoerceValueCallback 종속성에 대 한 속성 또한 내부적으로 될 때마다 호출 되는 종속성 속성 값 다시 평가 하는 WPFWPF 속성 시스템입니다.In addition to being explicitly invoked through calling CoerceValue, the CoerceValueCallback for a dependency property is also invoked internally whenever the dependency property value is being re-evaluated by the WPFWPF property system.

호출 하는 경우는 CoerceValue 메서드를 호출 하는 궁극적으로 지정 하는 속성에 대 한 강제 값 콜백 합니다.When you invoke the CoerceValue method, you are ultimately invoking the coerce value callback for the property that you specify. 일반적으로 호출 됩니다 CoerceValue 강제 값 콜백이 있는지 알고 있는 경우 및 강제 변환에 대 한 조건을 알고 있는 경우에 합니다.Typically you will invoke CoerceValue only if you know that a coerce value callback exists, and if you know the callback's criteria for coercion.

호출에 대 한 가장 일반적인 시나리오 CoerceValue 서로의 값 종속 방식에서에 영향을 주는 관련된 속성의 클래스 처리 하거나 속성 변경 콜백을 내입니다.The most common scenario for calling CoerceValue is within class handling or property change callbacks of related properties that influence each other's values in a dependent way. 자세한 내용은 종속성 속성 콜백 및 유효성 검사를 참조하세요.For more information, see Dependency Property Callbacks and Validation.

적용 대상

추가 정보