依存関係プロパティのメタデータ

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

Windows Presentation Foundation (WPF) プロパティシステムには、リフレクションや一般的な共通言語ランタイム (CLR) 特性から得られる以上の詳細なプロパティ情報を提供するメタデータ報告システムが含まれています。依存関係プロパティのメタデータは、依存関係プロパティを定義するクラスで個別に割り当てることも、依存関係プロパティを別のクラスに追加する際に変更することもできます。また、依存関係プロパティをその定義元の基本クラスから継承するすべての派生クラスで明確にオーバーライドすることもできます。

このトピックには次のセクションが含まれています。

必要条件
依存関係プロパティのメタデータの使用方法
メタデータ API
メタデータをオーバーライドする場合、クラスを派生する場合
既存のメタデータを変更するシナリオ
関連トピック

必要条件

このトピックでは、ユーザーが Windows Presentation Foundation (WPF) クラスの既存の依存関係プロパティの使用という観点から依存関係プロパティを理解し、「依存関係プロパティの概要」トピックを通読していることを前提としています。このトピックの例に従うには、XAML について理解し、WPF アプリケーションの作成方法に精通している必要があります。

依存関係プロパティのメタデータの使用方法

依存関係プロパティのメタデータは、依存プロパティの特性を照会して調べることができるオブジェクトとして存在します。また、プロパティシステムは、特定の依存関係プロパティを処理する際に、このメタデータに頻繁にアクセスします。依存関係プロパティのメタデータオブジェクトには、次のような情報が格納されます。

依存関係プロパティの既定値 (ローカル値、スタイル、継承などによってその他の依存関係プロパティ値が指定されない場合)。依存関係プロパティの値を割り当てる際の、既定値と、プロパティシステムで使用される優先順位の関係に関する詳細な説明については、「依存関係プロパティ値の優先順位」を参照してください。
所有者型に基づく強制または変更通知の動作に影響を与えるコールバック実装への参照。多くの場合、これらのコールバックは非パブリックなアクセスレベルで定義されます。したがって、参照が、許可されたアクセススコープ内にない限り、一般にメタデータから実際の参照を取得することはできません。依存関係プロパティのコールバックの詳細については、「依存関係プロパティのコールバックと検証」を参照してください。
対象の依存関係プロパティが WPF フレームワークレベルのプロパティと見なされる場合、WPF フレームワークレベルの依存関係プロパティ特性がメタデータに含まれる可能性があります。これは、WPF フレームワークレベルのレイアウトエンジンやプロパティ継承ロジックなどのサービスの情報および状態を報告します。この内容に関する依存関係プロパティのメタデータの詳細については、「フレームワークプロパティメタデータ」を参照してください。

メタデータ API

プロパティシステムで使用されるほとんどのメタデータ情報を報告する型は PropertyMetadata クラスです。メタデータインスタンスは、依存関係プロパティをプロパティシステムに登録する際に必要に応じて指定されます。それ自体を所有者として追加する追加の型、または基本クラスの依存関係プロパティ定義から継承したメタデータをオーバーライドする追加の型に再度指定することもできます (プロパティ登録でメタデータが指定されない場合は、そのクラスの既定値を使用して既定の PropertyMetadata が作成されます)。DependencyObject インスタンスの依存関係プロパティからメタデータを取得するさまざまな GetMetadata オーバーロードを呼び出すと、登録されているメタデータが PropertyMetadata として返されます。

PropertyMetadata クラスは、WPF フレームワークレベルクラスなどのアーキテクチャ区分に対してより具体的なメタデータを提供するために派生されます。UIPropertyMetadata は、アニメーション報告を追加し、FrameworkPropertyMetadata は、前のセクションで説明した WPF フレームワークレベルプロパティを提供します。依存関係プロパティを登録すると、これらの PropertyMetadata 派生クラスにその依存関係プロパティを登録できるようになります。メタデータを検査すると、基本 PropertyMetadata 型が派生クラスにキャストされる場合があります。これにより、より具体的な情報プロパティを検査することができます。

メモ :
このドキュメントでは、FrameworkPropertyMetadata で指定できるプロパティ特性を "フラグ" と呼ぶことがあります。依存関係プロパティの登録やメタデータのオーバーライドで使用するメタデータインスタンスを新しく作成する場合、フラグ列挙体である FrameworkPropertyMetadataOptions を使用してこれらの値を指定し、この列挙体の値 (連結された値である可能性があります) を FrameworkPropertyMetadata コンストラクタに渡します。ただし、メタデータが構築されると、これらのオプション特性は、構築元の列挙値ではなく、一連のブール型プロパティとして FrameworkPropertyMetadata 内で公開されます。これらのブール型プロパティを使用すると、目的の情報を取得するためにフラグ列挙値に対してマスクを適用することなく、各条件をチェックすることができます。コンストラクタは、コンストラクタシグネチャを適切な長さに保つために、連結された FrameworkPropertyMetadataOptions を使用します。一方、実際に構築されたメタデータは、より直感的な方法でメタデータを照会できるようにするために、プロパティを個別に公開します。

このドキュメントでは、FrameworkPropertyMetadata で指定できるプロパティ特性を "フラグ" と呼ぶことがあります。依存関係プロパティの登録やメタデータのオーバーライドで使用するメタデータインスタンスを新しく作成する場合、フラグ列挙体である FrameworkPropertyMetadataOptions を使用してこれらの値を指定し、この列挙体の値 (連結された値である可能性があります) を FrameworkPropertyMetadata コンストラクタに渡します。ただし、メタデータが構築されると、これらのオプション特性は、構築元の列挙値ではなく、一連のブール型プロパティとして FrameworkPropertyMetadata 内で公開されます。これらのブール型プロパティを使用すると、目的の情報を取得するためにフラグ列挙値に対してマスクを適用することなく、各条件をチェックすることができます。コンストラクタは、コンストラクタシグネチャを適切な長さに保つために、連結された FrameworkPropertyMetadataOptions を使用します。一方、実際に構築されたメタデータは、より直感的な方法でメタデータを照会できるようにするために、プロパティを個別に公開します。

メタデータをオーバーライドする場合、クラスを派生する場合

WPF プロパティシステムには、依存関係プロパティを完全に再実装することなく、依存関係プロパティの一部の特性を変更するための機能が用意されています。これは、特定の型に存在する依存関係プロパティについて、そのプロパティメタデータの別のインスタンスを構築することで実現されます。既存の依存関係プロパティの大部分は仮想プロパティではありません。したがって、厳密には、継承クラスでの依存関係プロパティの "再実装" は、既存のメンバをシャドウすることによってのみ実現されます。

型の依存関係プロパティに対して有効にしようとしているシナリオが、既存の依存関係プロパティの特性の変更では実現できない場合、派生クラスを作成し、その派生クラスでカスタム依存関係プロパティを宣言することが必要になる場合があります。カスタム依存関係プロパティは、WPFAPI で定義されている依存関係プロパティとまったく同じように動作します。カスタム依存関係プロパティの詳細については、「カスタム依存関係プロパティ」を参照してください。

オーバーライドすることができない依存関係プロパティの代表的な特性の 1 つは、依存関係プロパティの値型です。目的の動作にほぼ合致する依存関係プロパティを継承していても、その依存関係プロパティに別の型が必要な場合には、カスタム依存関係プロパティを実装し、型変換またはカスタムクラスのその他の実装を通じてプロパティをリンクする必要があります。また、既存の ValidateValueCallback を置換することはできません。このコールバックが、そのメタデータ内ではなく、登録フィールド自体に存在するためです。

既存のメタデータを変更するシナリオ

既存の依存関係プロパティのメタデータを使用している場合、依存関係プロパティのメタデータを変更する一般的なシナリオの 1 つは、既定値を変更することです。プロパティシステムコールバックの変更または追加は、より高度なシナリオです。依存関係プロパティ間の異なる相互関係が派生クラスの実装に含まれている場合は、プロパティシステムコールバックの変更または追加が必要になることがあります。コードと宣言的な使用方法の両方をサポートするプログラミングモデルを使用する条件の 1 つとして、プロパティを任意の順序で設定できる必要があります。したがって、依存関係プロパティはすべて、コンテキストを使用せずにジャストインタイムで設定する必要があります。また、設定順序 (コンストラクタ内の順序など) に依存することもできません。この内容に関するプロパティシステムの詳細については、「依存関係プロパティのコールバックと検証」を参照してください。検証コールバックは、メタデータの一部ではなく、依存関係プロパティ識別子の一部であることに注意してください。したがって、検証コールバックは、メタデータのオーバーライドでは変更できません。

既存の依存関係プロパティに対して、WPF フレームワークレベルのプロパティのメタデータオプションの変更が必要になる場合があります。これらのオプションは、WPF フレームワークレベルのプロパティに関する特定の既知の条件を、レイアウトシステムなどの他の WPF フレームワークレベルのプロセスに伝達します。通常、これらのオプションを設定するのは、新しい依存関係プロパティを登録するときだけです。ただし、OverrideMetadata 呼び出しまたは AddOwner 呼び出しの一部として WPF フレームワークレベルのプロパティのメタデータを変更することもできます。使用する具体的な値および詳細については、「フレームワークプロパティメタデータ」を参照してください。新しく登録した依存関係プロパティに対してこれらのオプションを設定する方法の詳細については、「カスタム依存関係プロパティ」を参照してください。

メタデータのオーバーライド

メタデータのオーバーライドの主な目的は、型に存在する依存関係プロパティに適用される、メタデータから派生したさまざまな動作を変更できるようにすることです。この理由については、「メタデータ」セクションで詳しく説明します。コード例を含む詳細については、「方法 : 依存関係プロパティのメタデータをオーバーライドする」を参照してください。

プロパティのメタデータは、登録 (Register) の呼び出し時に依存関係プロパティに対して指定できます。ただし、多くの場合、その依存関係プロパティを継承するクラスに対して、型固有のメタデータを提供する必要があります。これを行うには、OverrideMetadata メソッドを呼び出します。WPF API の例では、Focusable 依存関係プロパティを最初に登録する型は FrameworkElement クラスです。ただし、Control クラスは、この依存関係プロパティのメタデータをオーバーライドし、それ自体の初期既定値を false から true に変更して提供します。オーバーライドしない場合は、元の Focusable 実装を再利用します。

メタデータをオーバーライドすると、さまざまなメタデータ特性がマージされるか置き換えられます。

PropertyChangedCallback はマージされます。新しい PropertyChangedCallback を追加すると、そのコールバックがメタデータに格納されます。オーバーライド時に PropertyChangedCallback を指定しないと、PropertyChangedCallback の値が昇格され、メタデータでそれを指定した最も近い先祖からの参照となります。
PropertyChangedCallback の実際のプロパティシステム動作では、階層内のすべてのメタデータ所有者用の実装が維持されてテーブルに追加されます。プロパティシステムによる実行順序としては、派生回数の最も多いクラスのコールバックが最初に呼び出されます。
DefaultValue は置き換えられます。オーバーライド時に PropertyChangedCallback を指定しないと、DefaultValue の値は、メタデータでそれを指定した最も近い先祖によって決まります。
CoerceValueCallback 実装は置き換えられます。新しい CoerceValueCallback を追加すると、そのコールバックがメタデータに格納されます。オーバーライド時に CoerceValueCallback を指定しないと、CoerceValueCallback の値が昇格され、メタデータでそれを指定した最も近い先祖からの参照となります。
プロパティシステム動作では、直接のメタデータ内の CoerceValueCallback だけが呼び出されます。階層内の他の CoerceValueCallback 実装への参照は行われません。

この動作は Merge によって実装され、派生メタデータクラス上でオーバーライドできます。

添付プロパティのメタデータのオーバーライド

WPF では、添付プロパティは依存関係プロパティとして実装されます。このことは、添付プロパティもプロパティメタデータを持ち、これを個々のクラスでオーバーライドできることを意味します。WPF の添付プロパティのスコープでは、通常、任意の DependencyObject に、添付プロパティを設定できます。したがって、クラスのインスタンスで設定されている場合、DependencyObject 派生クラスは添付プロパティのメタデータをオーバーライドできます。オーバーライドできるのは、既定値、コールバック、または WPF フレームワークレベルの特性報告プロパティです。添付プロパティがクラスのインスタンスで設定されている場合、そのオーバーライドプロパティメタデータ特性が適用されます。たとえば、プロパティが他では特に指定されていないときには、オーバーライド値がクラスのインスタンス上の添付プロパティの値として報告されるように、既定値をオーバーライドできます。

メモ :
Inherits プロパティは、添付プロパティに関係しません。

既存の依存関係プロパティの所有者としてのクラスの追加

クラスは、AddOwner メソッドを使用することで、それ自体を登録済みの依存関係プロパティの所有者として追加できます。これにより、当初は別の型に対して登録された依存関係プロパティをクラスで使用できるようになります。通常、追加するクラスは、所有者としてその依存関係プロパティを最初に登録した型の派生クラスではありません。これにより、元の所有者クラスと追加するクラスが同一のクラス階層内にない場合でも、クラスとその派生クラスで依存関係プロパティの実装を "継承" することが事実上可能になります。また、追加するクラスとすべての派生クラスでは、型固有のメタデータを元の依存関係プロパティに提供することができます。

追加するクラスは、プロパティシステムのユーティリティメソッドを介してそれ自体を所有者として追加するだけでなく、追加のパブリックメンバをそれ自体で宣言する必要があります。これは、依存関係プロパティを完全な形でプロパティシステムに登録し、コードとマークアップの両方に対して公開するためです。既存の依存関係プロパティを追加するクラスは、その依存関係プロパティのオブジェクトモデルを公開する限り、新しいカスタム依存関係プロパティを定義するクラスと同様の役割を負います。これらのメンバの中で最初に公開するのは、依存関係プロパティの識別子フィールドです。このフィールドは、AddOwner 呼び出しの戻り値に割り当てられる、DependencyProperty 型の public static readonly フィールドである必要があります。2 番目に定義するメンバは、共通言語ランタイム (CLR) の "ラッパー" プロパティです。ラッパーを使用すると、コード内での依存関係プロパティの操作がずっと簡単になります (SetValue を毎回呼び出す必要がなくなり、ラッパー内で 1 回呼び出すだけで済むようになります)。このラッパーの実装方法は、カスタム依存関係プロパティを登録する場合の実装方法とまったく同じです。依存関係プロパティの実装の詳細については、「カスタム依存関係プロパティ」および「方法 : 依存関係プロパティの所有者の種類を追加する」を参照してください。

AddOwner および添付プロパティ

所有者クラスで添付プロパティとして定義されている依存関係プロパティに対して、AddOwner を呼び出すことができます。通常、これは、以前の添付プロパティを非添付の依存関係プロパティとして公開する目的で行います。次に、AddOwner の戻り値を、依存関係プロパティの識別子として使用される public static readonly フィールドとして公開し、プロパティがメンバテーブルに表示され、クラス内で非添付プロパティを使用できるように、適切な "ラッパー" プロパティを定義します。