DependencyProperty Kelas

Definisi

Ruang nama:

System.Windows

Rakitan:

WindowsBase.dll

Mewakili properti yang dapat diatur melalui metode seperti, gaya, pengikatan data, animasi, dan warisan.

public ref class DependencyProperty sealed

[System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
public sealed class DependencyProperty

[<System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")>]
type DependencyProperty = class

Public NotInheritable Class DependencyProperty

Warisan

Object

DependencyProperty

Atribut

TypeConverterAttribute

Keterangan

DependencyProperty mendukung kemampuan berikut di Windows Presentation Foundation (WPF):

• Properti dapat diatur dalam gaya. Untuk informasi selengkapnya, lihat Styling dan Templating.

• Properti dapat diatur melalui pengikatan data. Untuk informasi selengkapnya tentang properti dependensi pengikatan data, lihat Cara: Mengikat Properti Dua Kontrol.

• Properti dapat diatur dengan referensi sumber daya dinamis. Untuk informasi selengkapnya, lihat Sumber Daya XAML.

• Properti dapat mewarisi nilainya secara otomatis dari elemen induk di pohon elemen. Untuk informasi selengkapnya, lihat Pewarisan Nilai Properti .

• Properti dapat dianimasikan. Untuk informasi selengkapnya, lihat Gambaran Umum Animasi .

• Properti dapat melaporkan ketika nilai properti sebelumnya telah diubah dan nilai properti dapat dipaksa. Untuk informasi selengkapnya, lihat Callback Properti Dependensi danValidasi .

• Properti melaporkan informasi ke WPF, seperti apakah mengubah nilai properti harus mengharuskan sistem tata letak untuk menyusun ulang visual untuk elemen.

• Properti menerima dukungan di WPF Designer untuk Visual Studio. Misalnya, properti dapat diedit di jendela Properti .

Untuk mempelajari selengkapnya tentang properti dependensi, lihat Gambaran Umum Properti Dependensi . Jika Anda ingin properti pada jenis kustom Anda mendukung kemampuan dalam daftar sebelumnya, Anda harus membuat properti dependensi. Untuk mempelajari cara membuat properti dependensi kustom, lihat Properti Dependensi Kustom.

Properti terlampir adalah properti yang memungkinkan objek apa pun melaporkan informasi ke jenis yang menentukan properti terlampir. Di WPF, jenis apa pun yang mewarisi dari DependencyObject dapat menggunakan properti terlampir terlepas dari apakah jenis mewarisi dari jenis yang menentukan properti. Properti terlampir adalah fitur bahasa XAML. Untuk mengatur properti terlampir di XAML, gunakan ownerType.sintaks propertyName. Contoh properti terlampir adalah properti DockPanel.Dock. Jika Anda ingin membuat properti yang dapat digunakan pada semua jenis DependencyObject, maka Anda harus membuat properti terlampir. Untuk mempelajari selengkapnya tentang properti terlampir, termasuk cara membuatnya, lihat Gambaran Umum Properti Terlampir .

Penggunaan Atribut XAML

<object property="dependencyPropertyName"/>  

-atau-

<object property="ownerType.dependencyPropertyName"/>  

-atau-

<object property="attachedPropertyOwnerType.attachedPropertyName"/>  

Nilai XAML

dependencyPropertyName
String yang menentukan DependencyProperty.Name properti dependensi yang diinginkan. Ini dapat didahului dengan awalan namespace XML jika properti tidak berada di namespace XML default (untuk detailnya, lihat Namespace XAML dan Pemetaan Namespace layanan untuk WPF XAML.)

ownerType.dependencyPropertyName
String yang menentukan jenis pemilik properti dependensi, titik (.), lalu DependencyProperty.Name. ownerType juga dapat didahului dengan awalan namespace XML. Penggunaan ini khusus untuk gaya dan templat yang terlambat terikat, di mana pemilik properti dependensi harus ditentukan untuk konteks penguraian karena TargetType belum diketahui. Untuk informasi selengkapnya, lihat Styling dan Templating.

attachedPropertyOwnerType .attachedPropertyName
String yang menentukan pemilik properti terlampir, titik (.), lalu nama properti terlampir. attachedPropertyOwnerType juga dapat didahului dengan awalan namespace XML.

Bidang

UnsetValue

Menentukan nilai statis yang digunakan oleh sistem properti WPF daripada null untuk menunjukkan bahwa properti ada, tetapi tidak memiliki nilai yang ditetapkan oleh sistem properti.

Properti

DefaultMetadata	Mendapatkan metadata default properti dependensi.
GlobalIndex	Mendapatkan nilai yang dihasilkan secara internal yang secara unik mengidentifikasi properti dependensi.
Name	Mendapatkan nama properti dependensi.
OwnerType	Mendapatkan jenis objek yang mendaftarkan properti dependensi dengan sistem properti, atau menambahkan dirinya sebagai pemilik properti.
PropertyType	Mendapatkan jenis yang digunakan properti dependensi untuk nilainya.
ReadOnly	Mendapatkan nilai yang menunjukkan apakah properti dependensi yang diidentifikasi oleh instans DependencyProperty ini adalah properti dependensi baca-saja.
ValidateValueCallback	Mendapatkan panggilan balik validasi nilai untuk properti dependensi.

Metode

AddOwner(Type)	Menambahkan jenis lain sebagai pemilik properti dependensi yang telah terdaftar.
AddOwner(Type, PropertyMetadata)	Menambahkan jenis lain sebagai pemilik properti dependensi yang telah terdaftar, menyediakan metadata properti dependensi untuk properti dependensi karena akan ada pada jenis pemilik yang disediakan.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Mengembalikan kode hash untuk DependencyPropertyini.
GetMetadata(DependencyObject)	Mengembalikan metadata untuk properti dependensi ini karena ada pada instans objek yang ditentukan.
GetMetadata(DependencyObjectType)	Mengembalikan metadata untuk properti dependensi ini karena ada pada jenis tertentu.
GetMetadata(Type)	Mengembalikan metadata untuk properti dependensi ini karena ada pada jenis yang ada yang ditentukan.
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
IsValidType(Object)	Menentukan apakah nilai yang ditentukan dapat diterima untuk jenis properti dependensi ini, seperti yang diperiksa terhadap jenis properti yang disediakan dalam pendaftaran properti dependensi asli.
IsValidValue(Object)	Menentukan apakah nilai yang disediakan diterima untuk jenis properti melalui pemeriksaan jenis dasar, dan juga berpotensi jika berada dalam rentang nilai yang diizinkan untuk jenis tersebut.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
OverrideMetadata(Type, PropertyMetadata)	Menentukan metadata alternatif untuk properti dependensi ini ketika ada pada instans jenis tertentu, mengambil alih metadata yang ada untuk properti dependensi seperti yang diwarisi dari jenis dasar.
OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey)	Menyediakan metadata alternatif untuk properti dependensi baca-saja ketika ada pada instans jenis tertentu, menggantikan metadata yang disediakan dalam pendaftaran properti dependensi awal. Anda harus meneruskan DependencyPropertyKey untuk properti dependensi baca-saja untuk menghindari peningkatan pengecualian.
Register(String, Type, Type)	Mendaftarkan properti dependensi dengan nama properti, jenis properti, dan jenis pemilik yang ditentukan.
Register(String, Type, Type, PropertyMetadata)	Mendaftarkan properti dependensi dengan nama properti, jenis properti, jenis pemilik, dan metadata properti yang ditentukan.
Register(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Mendaftarkan properti dependensi dengan nama properti, jenis properti, jenis pemilik, metadata properti yang ditentukan, dan panggilan balik validasi nilai untuk properti .
RegisterAttached(String, Type, Type)	Mendaftarkan properti terlampir dengan nama properti, jenis properti, dan jenis pemilik yang ditentukan.
RegisterAttached(String, Type, Type, PropertyMetadata)	Mendaftarkan properti terlampir dengan nama properti, jenis properti, jenis pemilik, dan metadata properti yang ditentukan.
RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Mendaftarkan properti terlampir dengan jenis properti, jenis pemilik, metadata properti, dan panggilan balik validasi nilai yang ditentukan untuk properti .
RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)	Mendaftarkan properti terlampir baca-saja, dengan jenis properti, jenis pemilik, dan metadata properti yang ditentukan.
RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Mendaftarkan properti terlampir baca-saja, dengan jenis properti yang ditentukan, jenis pemilik, metadata properti, dan panggilan balik validasi.
RegisterReadOnly(String, Type, Type, PropertyMetadata)	Mendaftarkan properti dependensi baca-saja, dengan jenis properti, jenis pemilik, dan metadata properti yang ditentukan.
RegisterReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Mendaftarkan properti dependensi baca-saja, dengan jenis properti yang ditentukan, jenis pemilik, metadata properti, dan panggilan balik validasi.
ToString()	Mengembalikan representasi string dari properti dependensi.

Lihat juga

• DependencyObject
• DependencyPropertyHelper