DependencyObject.CoerceValue(DependencyProperty) DependencyObject.CoerceValue(DependencyProperty) DependencyObject.CoerceValue(DependencyProperty) DependencyObject.CoerceValue(DependencyProperty) Method

定義

指定した依存関係プロパティの値を強制します。 これは、呼び出し元の DependencyObject の依存関係プロパティのプロパティ メタデータで指定されている CoerceValueCallback 関数を呼び出すことによって実現されます。

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 DependencyProperty DependencyProperty DependencyProperty

強制する依存関係プロパティの識別子。

例外

指定した dp またはその値が無効であるか、存在しません。

次の例ではCoerceValue内で、PropertyChangedCallbackとして使用される実装、PropertyChangedCallbackの同じクラスでさまざまな依存関係プロパティ。 これは、依存関係プロパティ間の値が true の依存関係を導入するための一般的なパターンです。

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依存関係のプロパティも呼び出される内部で依存関係プロパティの値が再評価されるたびに、WPFプロパティ システム。

呼び出した場合、CoerceValueメソッドでは、指定したプロパティの強制値コールバック呼び出す最終的にします。 通常は呼び出すCoerceValue強制値コールバックが存在することがわかっている場合、および強制型変換のコールバックの条件がわかっている場合のみです。

呼び出し元の最も一般的なシナリオCoerceValueが依存している方法で他の値に影響を与える関連するプロパティのクラス処理またはプロパティ変更コールバック内で。 詳しくは、「依存関係プロパティのコールバックと検証」を参照してください。

適用対象

こちらもご覧ください