DependencyProperty.Register メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定したプロパティ名、プロパティの型、所有者の型、およびプロパティのプロパティ メタデータを使用して依存関係プロパティを登録します。 このメソッドは、登録されている依存関係プロパティを所有する DependencyObject 派生クラスを定義または初期化するときに使用します。
static DependencyProperty Register(winrt::hstring const& name, TypeName const& propertyType, TypeName const& ownerType, PropertyMetadata const& typeMetadata);public static DependencyProperty Register(string name, System.Type propertyType, System.Type ownerType, PropertyMetadata typeMetadata);function register(name, propertyType, ownerType, typeMetadata)Public Shared Function Register (name As String, propertyType As Type, ownerType As Type, typeMetadata As PropertyMetadata) As DependencyPropertyパラメーター
- name
-
String
winrt::hstring
登録する依存関係プロパティの名前。
- typeMetadata
- PropertyMetadata
プロパティ メタデータ インスタンス。 これには、既定値と PropertyChangedCallback 実装リファレンスを含めることができます。 このパラメーターにnullを渡すことは、既定値パラメーターとして null を指定して PropertyMetadata.Create を呼び出すことによって作成された新しい PropertyMetadata インスタンスを渡すことと同じです。
返品
DependencyObject 派生クラスのパブリック静的読み取り専用フィールドに通常格納される依存関係プロパティ識別子。 その後、識別子は、独自のコードとサードパーティのユーザー コードの両方で使用され、後で依存関係プロパティを参照し、その値をプログラムで設定したり、コードで Binding をアタッチしたりするなどの操作に使用されます。
注釈
カスタム依存関係プロパティを登録する方法については、「カスタム依存関係プロパティ 」のトピックで詳しく説明します (例を参照)。
依存関係プロパティの登録は、通常、アプリが最初に開始されたとき、またはアプリ コードによって定義された DependencyObject 派生クラスが最初に使用される場合にのみ行います。 依存関係プロパティは、アプリの有効期間の早い段階で登録して、アプリ内の他のコードと XAML が登録されて使用可能になるまで依存関係プロパティを使用しないようにする必要があります。 正確に登録する方法とタイミングは、プログラミング言語によって異なります。 C# では、依存関係プロパティを所有するクラスの静的クラス初期化中に依存関係プロパティを登録するのが一般的です。 こうすることで、インスタンスを初期化するコードまたは XAML がその静的構築を呼び出し、依存関係プロパティを登録します。 C++ の場合、静的クラスの初期化は使用できない手法であるため、通常は、 アプリケーション オブジェクトの初期化の一環として、アプリで使用するすべてのカスタム依存関係プロパティを登録するアプリ全体のヘルパー メソッドを定義する必要があります。 C++ に必要な特別な手法など、カスタム依存関係プロパティを登録する方法とタイミングの例については、「 カスタム依存関係プロパティ」を参照してください。