DependencyObject.CoerceValue(DependencyProperty) Method

Definition

지정된 종속성 속성의 값을 강제 변환합니다.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)

Parameters

dp
DependencyProperty

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

Exceptions

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

Examples

다음 예제에서는 동일한 클래스의 다른 종속성 속성에 대 한 PropertyChangedCallback으로 사용 되는 PropertyChangedCallback 구현 내에서 CoerceValue를 호출 합니다.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

Remarks

CoerceValue를 호출 하 여 명시적으로 호출 하는 것 외에도 종속성 속성 값이 WPFWPF 속성 시스템에 의해 다시 계산 될 때마다 종속성 속성의 CoerceValueCallback 내부적으로 호출 됩니다.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.

Applies to

See also