DependencyProperty.Register メソッド

 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

パラメーター

戻り値

DependencyObject 派生クラスのパブリック静的読み取り専用フィールドに通常格納される 依存関係 プロパティ識別子。 その後、識別子は、独自のコードとサードパーティのユーザー コードの両方で使用され、後で依存関係プロパティを参照し、その値をプログラムで設定したり、 コードで Binding をアタッチしたりするなどの操作に使用されます。

注釈

カスタム依存関係プロパティを登録する方法については、「 カスタム依存関係プロパティ」のトピックで詳しく説明されています (例を参照)。

通常、依存関係プロパティの登録は、アプリが最初に開始されたとき、またはアプリ コードによって定義された DependencyObject 派生クラスが最初に使用される場合にのみ行います。 依存関係プロパティは、アプリの有効期間の早い段階で登録する必要があります。これにより、アプリ内の他のコードと XAML が、依存関係プロパティを登録して使用できるようになる前に、依存関係プロパティの使用を試みないようにする必要があります。 正確に登録する方法とタイミングは、プログラミング言語によって異なります。 C# または Microsoft Visual Basic の場合、依存関係プロパティを所有するクラスの静的クラスの初期化中に依存関係プロパティを登録するのが一般的です。 このようにして、インスタンスを初期化するコードまたは XAML は、その静的構築を呼び出し、依存関係プロパティを登録します。 Visual C++ コンポーネント拡張機能 (C++/CX) の場合、静的クラスの初期化は使用できない手法であるため、通常は、 アプリケーション オブジェクトの初期化の一環として、アプリで使用するすべてのカスタム依存関係プロパティを登録するアプリ全体のヘルパー メソッドを定義する必要があります。 Visual C++ コンポーネント拡張機能 (C++/CX) に必要な特別な手法など、カスタム依存関係プロパティを登録する方法とタイミングの例については、「 カスタム依存関係プロパティ」を参照してください。

適用対象

こちらもご覧ください

• カスタム依存関係プロパティ
• 依存関係プロパティの概要
• XAML ユーザーとカスタム コントロールのサンプル