DependencyProperty.Register 方法

定義

命名空間:

Microsoft.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 的類型參考 (，這是 Visual C++ 元件延伸模組的 TypeName 協助程式結構， (C++/CX) ) 。

ownerType

TypeName Type

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

typeMetadata

PropertyMetadata

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

傳回

DependencyProperty

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

備註

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

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

另請參閱

• 自訂相依性屬性
• 相依性屬性概觀
• XAML 使用者和自訂控制項範例