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
登録する依存関係プロパティの名前。
型参照としてのプロパティの型 (System.Type for Microsoft .NET、Visual C++ コンポーネント拡張機能の TypeName ヘルパー構造体 (C++/CX))。
依存関係プロパティを型参照として登録している所有者型 (System.Type for Microsoft .NET、Visual C++ コンポーネント拡張機能 (C++/CX) の TypeName ヘルパー構造体)。
- typeMetadata
- PropertyMetadata
プロパティ メタデータ インスタンス。 これには、既定値と PropertyChangedCallback 実装リファレンスを含めることができます。 このパラメーターの受け渡し null は、既定値パラメーターとして PropertyMetadata.Create を呼び出して作成された新しい PropertyMetadata インスタンスを渡すことと null 同じです。
戻り値
DependencyObject 派生クラスのパブリック静的読み取り専用フィールドに通常格納される 依存関係 プロパティ識別子。 その後、識別子は、プログラムで値を設定したり、コードで Binding をアタッチしたりするなどの操作のために、独自のコードとサードパーティのユーザー コードの両方で使用され、依存関係プロパティを後で参照します。
注釈
カスタム依存関係プロパティを登録する方法については 、トピック「カスタム依存関係プロパティ」で詳しく説明されています (例を参照)。
依存関係プロパティの登録は、通常、アプリが最初に起動されたとき、またはアプリ コードによって定義された DependencyObject 派生クラスが最初に使用される場合にのみ行います。 アプリの有効期間の早い段階で依存関係プロパティを登録して、アプリ内の他のコードと XAML が依存関係プロパティを登録して使用可能にする前に使用しないようにする必要があります。 登録する方法とタイミングは、プログラミング言語によって正確に異なります。 C# または Microsoft Visual Basic の場合、依存関係プロパティを所有するクラスの静的クラスの初期化中に依存関係プロパティを登録するのが一般的です。 このように、インスタンスを初期化するコードまたは XAML は、その静的構築を呼び出し、依存関係プロパティを登録します。 Visual C++ コンポーネント拡張機能 (C++/CX) の場合、静的クラスの初期化は使用できない手法であるため、通常は、 アプリケーション オブジェクトの初期化の一環として、アプリで使用するすべてのカスタム依存関係プロパティを登録するアプリ全体のヘルパー メソッドを定義する必要があります。 Visual C++ コンポーネント拡張機能 (C++/CX) に必要な特別な手法など、カスタム依存関係プロパティを登録する方法とタイミングの例については、「 カスタム依存関係プロパティ」を参照してください。