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 此參數等同於透過呼叫 PropertyMetadata.Createnull 建立的新 PropertyMetadata 實例，該實例以預設值為參數。
傳回
一個通常儲存在 DependencyObject 衍生類別中公開靜態只讀欄位的相依屬性識別碼。 該識別碼隨後會被你自己的程式碼及任何第三方使用者程式碼用來參考該依賴屬性，例如程式設定其值或在程式碼中附加 綁定 。
備註
如何註冊自訂相依屬性，詳述於「 自訂相依屬性」主題中（附有範例）。
註冊相依屬性通常是在應用程式剛啟動或應用程式程式碼定義的 DependencyObject 衍生類別首次使用時才會做的事。 你需要在應用程式生命週期初期註冊相依屬性，以確保你應用程式中的其他程式碼和 XAML 不會在依賴性屬性註冊並可用之前嘗試使用它們。 註冊的方式與時間會依程式語言而異。 在 C# 中，通常會在擁有依賴屬性的類別初始化時登錄依賴屬性。 這樣任何初始化實例的程式碼或 XAML 都會呼叫這個靜態建構並登錄相依屬性。 對於 C++ 來說，靜態類別初始化不是可用的技術，因此你通常必須定義一個全應用程式的輔助方法，登錄應用程式打算使用的所有自訂相依屬性，作為 應用程式 物件初始化的一部分。 關於如何以及何時登錄自訂依賴屬性的範例，包括 C++ 所需的特殊技術，請參見 自訂依賴屬性。