DependencyProperty.IsValidValue(Object) メソッド

  • リファレンス

定義

名前空間:
System.Windows
アセンブリ:
WindowsBase.dll

指定した値がプロパティの型で受け入れ可能かどうかを基本型チェックによって判断します。さらに、その型の有効値の範囲内にこの値があるかどうかを判断することもあります。

public:
 bool IsValidValue(System::Object ^ value);
public bool IsValidValue (object value);
member this.IsValidValue : obj -> bool
Public Function IsValidValue (value As Object) As Boolean

パラメーター

value
Object

確認する値。

戻り値

Boolean

値が受け入れ可能で、適切な型または派生型である場合は true。それ以外の場合は false。

例

次の例では、 を依存関係プロパティで呼び出すSetValue前に チェックとして を使用IsValidValueします。

void TrySetValueWithValidate(DependencyObject target, DependencyProperty dp, object providedValue)
{
  if (dp.IsValidValue(providedValue))
  {
    target.SetValue(dp, providedValue);
  }
}

Private Sub TrySetValueWithValidate(ByVal target As DependencyObject, ByVal dp As DependencyProperty, ByVal providedValue As Object)
  If dp.IsValidValue(providedValue) Then
    target.SetValue(dp, providedValue)
  End If
End Sub

注釈

依存関係プロパティの場合、その型に使用できる値の範囲は、依存関係プロパティの登録で提供される を介して ValidateValueCallback 指定できます。

このメソッドは内部的に を呼び出します IsValidType 。 問題の依存関係プロパティに がない ValidateValueCallback場合、このメソッドを呼び出すことは、 の呼び出し IsValidTypeと実質的に同じです。 依存関係プロパティに が含ValidateValueCallbackまれている場合、および が返されたtrue場合IsValidType、返される値はコールバックに実装された値になります。

null 値は、参照型の依存関係プロパティまたは Nullable<T> 依存関係プロパティの有効な値であり、このような場合は を返します true 。 依存関係プロパティが参照でも型でもない Nullable<T> 場合は、 IsValidType 例外を発生させるのではなく、null 値を返 false します。

適用対象