DependencyProperty.Register 方法

  • 參考

定義

命名空間:
Windows.UI.Xaml
編輯

使用屬性的指定屬性名稱、屬性類型、擁有者類型和屬性中繼資料註冊相依性屬性。 在定義或初始化將擁有已註冊相 依性屬性的 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

要註冊之相依性屬性的名稱。

propertyType
TypeName Type

屬性的類型，作為 System.Type for Microsoft .NET 的 System.Type (參考，這是 Visual C++ 元件延伸模組的 TypeName 協助程式結構， (C++/CX) ) 。

ownerType
TypeName Type

註冊相依性屬性的擁有者類型，作為 System.Type for Microsoft .NET 的類型參考 (，這是 Visual C++ 元件延伸模組的 TypeName 協助程式結構， (C++/CX) ) 。

typeMetadata
PropertyMetadata

屬性中繼資料實例。 這可以包含預設值和 PropertyChangedCallback 實作參考。 null傳遞此參數相當於傳遞透過呼叫PropertyMetadata.Create作為 null 預設值參數所建立的新 PropertyMetadata 實例。

傳回

DependencyProperty

通常儲存在 DependencyObject 衍生類別的公用靜態唯讀欄位中的相依性屬性識別碼。 然後，您自己的程式碼和任何協力廠商使用者程式碼會使用識別碼，稍後參考相依性屬性，例如以程式設計方式設定其值或在程式碼中附加 Binding 。

備註

如何使用 自訂相依性屬性主題中的範例) ，詳細說明如何註冊自訂相依性屬性 (。

註冊相依性屬性通常是只有在應用程式第一次啟動或 App 程式碼所定義的 DependencyObject 衍生類別第一次使用時才會執行的動作。 您必須在應用程式存留期初期註冊相依性屬性，以確保應用程式中的其他程式碼和 XAML 不會先嘗試使用相依性屬性，再註冊並可供使用。 註冊的方式和時機會根據程式設計語言而有所不同。 針對 C# 或 Microsoft Visual Basic，通常會在擁有相依性屬性之類別的靜態類別初始化期間註冊相依性屬性。 如此一來，任何初始化 實例的程式碼或 XAML 都會叫用該靜態建構並註冊相依性屬性。 對於 Visual C++ 元件延伸模組 (C++/CX) ) ，靜態類別初始化不是可用的技術，因此您通常必須定義全應用程式協助程式方法，以註冊應用程式想要使用的所有自訂相依性屬性，做為 Application 物件初始化的一部分。 如需如何及何時註冊自訂相依性屬性的範例，包括 Visual C++ 元件延伸模組 (C++/CX) 所需的一些特殊技術，請參閱 自訂相依性屬性。

適用於

另請參閱