DependencyPropertyKey.OverrideMetadata(Type, PropertyMetadata) メソッド

public:
 void OverrideMetadata(Type ^ forType, System::Windows::PropertyMetadata ^ typeMetadata);

public void OverrideMetadata(Type forType, System.Windows.PropertyMetadata typeMetadata);

member this.OverrideMetadata : Type * System.Windows.PropertyMetadata -> unit

Public Sub OverrideMetadata (forType As Type, typeMetadata As PropertyMetadata)

パラメーター

例外

例

次の例では、クラスが継承する既存の読み取り専用依存関係プロパティのメタデータをオーバーライドします。 この場合、シナリオの目標は、基本プロパティメタデータに含まれていない強制値コールバックを追加することです。 メタデータのオーバーライドが通常適切であるその他の理由 (既定値の変更、 FrameworkPropertyMetadataOptions 値の追加など) のメタデータをオーバーライドすることもできます。

static Fishbowl() {
  Aquarium.AquariumSizeKey.OverrideMetadata(
    typeof(Aquarium),
    new PropertyMetadata(
      double.NaN,
      null,
      new CoerceValueCallback(CoerceFishbowlAquariumSize)
    )
  );
}

static object CoerceFishbowlAquariumSize(DependencyObject d,Object baseValue)
{
    //Aquarium is 2D, a Fishbowl is a round Aquarium, so the Size we return is the ellipse of that height/width rather than the rectangle
    Fishbowl fb = (Fishbowl)d;
    //other constraints assure that H,W are positive
    return Convert.ToInt32(Math.PI * (fb.Width / 2) * (fb.Height / 2));
}

Shared Sub New()
    Aquarium.AquariumSizeKey.OverrideMetadata(GetType(Aquarium), New PropertyMetadata(Double.NaN, Nothing, New CoerceValueCallback(AddressOf CoerceFishbowlAquariumSize)))
End Sub

Private Shared Function CoerceFishbowlAquariumSize(ByVal d As DependencyObject, ByVal baseValue As Object) As Object
    'Aquarium is 2D, a Fishbowl is a round Aquarium, so the Size we return is the ellipse of that height/width rather than the rectangle
    Dim fb As Fishbowl = CType(d, Fishbowl)
    'other constraints assure that H,W are positive
    Return Convert.ToInt32(Math.PI * (fb.Width / 2) * (fb.Height / 2))
End Function

注釈

読み取り専用依存関係プロパティのメタデータのオーバーライドは、読み取り/書き込み依存関係プロパティのメタデータのオーバーライドと同様の理由で行われ、メタデータで指定された動作によって設定された動作 (既定値など) が変更される可能性があるため、キー レベルでのアクセスが制限されます。

読み取り/書き込み依存関係プロパティと同様に、読み取り専用依存関係プロパティのメタデータのオーバーライドは、そのプロパティがプロパティ システムによって使用される前にのみ行う必要があります (これは、プロパティを登録するオブジェクトの特定のインスタンスがインスタンス化された時刻と同じ時間です)。 OverrideMetadataの呼び出しは、このメソッドのforType パラメーターとして自身を提供する型の静的コンストラクター内でのみ実行するか、そのクラスの同等の初期化を実行する必要があります。

このメソッドは、 OverrideMetadata メソッドに効果的に転送され、 DependencyPropertyKey インスタンスをキー パラメーターとして渡します。

こちらもご覧ください

• DependencyProperty
• OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey)