PropertyMetadata.CoerceValueCallback PropertyMetadata.CoerceValueCallback PropertyMetadata.CoerceValueCallback PropertyMetadata.CoerceValueCallback Property

定義

このメタデータに指定されている 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

プロパティ値

例外

依存関係プロパティの操作にいったん適用した後は、メタデータのプロパティを設定できません。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に 1 つ前を置き換えるものです。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したらIsSealedtrueでこのメタデータ インスタンスで例外が発生します。Attempting to set CoerceValueCallback once IsSealed is true on this metadata instance will raise an exception.

適用対象