Bagikan melalui


DependencyProperty.Register Metode

Definisi

Mendaftarkan properti dependensi dengan nama properti, jenis properti, jenis pemilik, dan metadata properti yang ditentukan untuk properti. Gunakan metode ini saat menentukan atau menginisialisasi kelas turunan DependencyObject yang akan memiliki properti dependensi terdaftar.

 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

Parameter

name
String

winrt::hstring

Nama properti dependensi yang akan didaftarkan.

propertyType
TypeName Type

Jenis properti , sebagai referensi jenis (System.Type untuk Microsoft .NET, struct pembantu TypeName untuk ekstensi komponen Visual C++ (C++/CX)).

ownerType
TypeName Type

Jenis pemilik yang mendaftarkan properti dependensi, sebagai referensi jenis (System.Type untuk Microsoft .NET, struct pembantu TypeName untuk ekstensi komponen Visual C++ (C++/CX)).

typeMetadata
PropertyMetadata

Instans metadata properti. Ini dapat berisi nilai default dan referensi implementasi PropertyChangedCallback . Meneruskan null untuk parameter ini setara dengan meneruskan instans PropertyMetadata baru yang dibuat dengan memanggil PropertyMetadata.Create dengan null sebagai parameter nilai default.

Mengembalikan

Pengidentifikasi properti dependensi yang biasanya disimpan di bidang baca-saja statis publik di kelas turunan DependencyObject Anda. Pengidentifikasi kemudian digunakan baik oleh kode Anda sendiri dan kode pengguna pihak ketiga mana pun untuk mereferensikan properti dependensi nanti, untuk operasi seperti mengatur nilainya secara terprogram atau melampirkan Pengikatan dalam kode.

Keterangan

Cara mendaftarkan properti dependensi kustom dijelaskan secara rinci (dengan contoh) dalam topik Properti dependensi kustom.

Mendaftarkan properti dependensi biasanya merupakan sesuatu yang hanya Anda lakukan saat aplikasi pertama kali dimulai atau kelas turunan DependencyObject yang ditentukan oleh kode aplikasi Anda pertama kali digunakan. Anda perlu mendaftarkan properti dependensi di awal masa pakai aplikasi untuk memastikan bahwa kode lain dan XAML di aplikasi Anda tidak mencoba menggunakan properti dependensi sebelum terdaftar dan tersedia. Persis bagaimana dan kapan mendaftar bervariasi, berdasarkan bahasa pemrograman. Untuk C# atau Microsoft Visual Basic adalah umum untuk mendaftarkan properti dependensi selama inisialisasi kelas statis kelas yang memiliki properti dependensi. Dengan begitu kode atau XAML apa pun yang menginisialisasi instans akan memanggil konstruksi statis tersebut dan mendaftarkan properti dependensi. Untuk ekstensi komponen Visual C++ (C++/CX)), inisialisasi kelas statis bukan teknik yang tersedia, jadi Anda biasanya harus menentukan metode pembantu seluruh aplikasi yang mendaftarkan semua properti dependensi kustom yang ingin digunakan aplikasi Anda, sebagai bagian dari inisialisasi objek Aplikasi . Untuk contoh bagaimana dan kapan mendaftarkan properti dependensi kustom, termasuk beberapa teknik khusus yang diperlukan untuk ekstensi komponen Visual C++ (C++/CX), lihat Properti dependensi kustom.

Berlaku untuk

Lihat juga