DependencyProperty.UnsetValue フィールド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
プロパティが存在するが、プロパティ システムによって値が設定されていないことを示すために null ではなく、WPF プロパティ システムによって使用される静的な値を指定します。
public: static initonly System::Object ^ UnsetValue;public static readonly object UnsetValue; staticval mutable UnsetValue : objPublic Shared ReadOnly UnsetValue As Object フィールド値
注釈
UnsetValue は、WPF プロパティ システムが要求された DependencyProperty 値を特定できないシナリオで使用されるセンチネル値です。
UnsetValue は nullではなく使用されます。これは、 null が有効なプロパティ値と、有効な (頻繁に使用される) DefaultValueである可能性があるためです。
UnsetValue が DependencyObject.GetValueから返されることはありません。 DependencyObject インスタンスの依存関係プロパティに対してDependencyObject.GetValueを呼び出すと、次のいずれかが適用されます。
依存関係プロパティには、メタデータで設定された既定値があり、その値が返されます。 この値は、 DefaultMetadataから取得される場合があります。
プロパティ システムによって他の値が確立され、既定値は関連しなくなりました。 詳細については、「 依存関係プロパティの値の優先順位」を参照してください。
UnsetValueのDefaultValueの設定は特に禁止されています。
DependencyObject.ReadLocalValue は、要求されたプロパティがローカルに設定されていない場合に UnsetValue を返します。
UnsetValue は、 CoerceValueCallbackの戻り値として使用する場合に特別な意味を持ちます。 詳細については、「 依存関係プロパティのコールバックと検証」を参照してください。
データベースにバインドする場合、 UnsetValue は Valueと同等ではないことに注意してください。これは、 Value が真の null と同等ではないことと同様の方法です。