PropertyMetadata.CoerceValueCallback プロパティ

定義

このメタデータに指定されている CoerceValueCallback 実装への参照を取得または設定します。Gets or sets a reference to a CoerceValueCallback implementation specified in this metadata.

public:
 property System::Windows::CoerceValueCallback ^ CoerceValueCallback { System::Windows::CoerceValueCallback ^ get(); void set(System::Windows::CoerceValueCallback ^ value); };
public System.Windows.CoerceValueCallback CoerceValueCallback { get; set; }
member this.CoerceValueCallback : System.Windows.CoerceValueCallback with get, set
Public Property CoerceValueCallback As CoerceValueCallback

プロパティ値

CoerceValueCallback 実装参照。A CoerceValueCallback implementation reference.

例外

依存関係プロパティの操作にいったん適用した後は、メタデータのプロパティを設定できません。Cannot set a metadata property once it is applied to a dependency property operation.

注釈

プロパティメタデータのコールバックは、通常、含んでいる型のパブリックメンバーではないため、既存の依存関係プロパティのメタデータを使用するだけのほとんどのシナリオでは、このプロパティの値は重要ではありません。The callbacks in property metadata are not typically public members on the containing type, so the value of this property is not important for most scenarios that just consume an existing dependency property's metadata. このプロパティが公開される理由の1つは、基本メタデータとオーバーライド/追加メタデータの両方がを指定してCoerceValueCallbackいる場合に、メタデータサブクラスが目的のマージロジックを実行できるようにするためです。One reason this property is exposed is so that metadata subclasses can perform their desired merge logic if both base metadata and overriding/adding metadata specify a CoerceValueCallback. ただし、のCoerceValueCallback既定のマージロジックでは、前のマージロジックが置き換えられます。However, the default merge logic for a CoerceValueCallback is to replace the previous one.

CoerceValueCallbackは、オブジェクトモデルで読み取り/書き込み可能として定義されます。CoerceValueCallback is defined in the object model as read-write. これは、 CoerceValueCallback PropertyMetadataオブジェクト自体を初期化した後で調整できるようにするためです。This is so CoerceValueCallback can be adjusted after initialization of the PropertyMetadata object itself. ただし、 RegisterAddOwner、またはOverrideMetadataの呼び出しの一部としてメタデータを使用すると、プロパティシステムによってそのメタデータインスタンスが封印され、プロパティが不変と見なされるようになります。However, once the metadata is consumed as part of a call to Register, AddOwner, or OverrideMetadata, the property system will seal that metadata instance and the properties are now considered immutable. このメタデータCoerceValueCallbackインスタンスIsSealed trueに1回設定しようとすると、例外が発生します。Attempting to set CoerceValueCallback once IsSealed is true on this metadata instance will raise an exception.

適用対象