PropertyMetadata Konstruktor

Definisi

Ruang nama:

System.Windows

Rakitan:

WindowsBase.dll

Menginisialisasi instans baru kelas PropertyMetadata.

Overload

PropertyMetadata()	Menginisialisasi instans baru kelas PropertyMetadata.
PropertyMetadata(Object)	Menginisialisasi instans PropertyMetadata baru kelas dengan nilai default tertentu untuk properti dependensi tempat metadata ini akan diterapkan.
PropertyMetadata(PropertyChangedCallback)	Menginisialisasi instans PropertyMetadata baru kelas dengan referensi implementasi yang ditentukan PropertyChangedCallback .
PropertyMetadata(Object, PropertyChangedCallback)	Menginisialisasi instans PropertyMetadata baru kelas dengan nilai default dan PropertyChangedCallback referensi implementasi yang ditentukan.
PropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)	Menginisialisasi instans PropertyMetadata baru kelas dengan nilai default dan panggilan balik yang ditentukan.

PropertyMetadata()

Menginisialisasi instans baru kelas PropertyMetadata.

public:
 PropertyMetadata();

public PropertyMetadata ();

Public Sub New ()

PropertyMetadata(Object)

Menginisialisasi instans PropertyMetadata baru kelas dengan nilai default tertentu untuk properti dependensi tempat metadata ini akan diterapkan.

public:
 PropertyMetadata(System::Object ^ defaultValue);

public PropertyMetadata (object defaultValue);

new System.Windows.PropertyMetadata : obj -> System.Windows.PropertyMetadata

Public Sub New (defaultValue As Object)

Parameter

defaultValue

Object

Nilai default yang akan ditentukan untuk properti dependensi, biasanya disediakan sebagai nilai dari beberapa jenis tertentu.

Pengecualian

ArgumentException

defaultValue tidak dapat diatur ke nilai UnsetValue.

Contoh

static PropertyMetadata pm;

pm = new PropertyMetadata(Double.NaN);

Keterangan

Jenis nilai yang disediakan harus defaultValue cocok atau terkait dengan jenis yang ditentukan dalam pendaftaran asli properti dependensi tempat metadata ini akan diterapkan. Ketidakcocokan antara jenis nilai default metadata dan jenis properti dependensi yang diterapkannya bisa sulit untuk di-debug, karena ketidakcocokan tidak dapat dideteksi selama kompilasi (ketidakcocokan akan meningkatkan pengecualian run-time).

Meskipun ini adalah default per konstruktor tanpa parameter, defaultValue dari UnsetValue tidak dapat ditentukan. Mencoba melakukannya akan menimbulkan pengecualian.

PropertyMetadata(PropertyChangedCallback)

Menginisialisasi instans PropertyMetadata baru kelas dengan referensi implementasi yang ditentukan PropertyChangedCallback .

public:
 PropertyMetadata(System::Windows::PropertyChangedCallback ^ propertyChangedCallback);

public PropertyMetadata (System.Windows.PropertyChangedCallback propertyChangedCallback);

new System.Windows.PropertyMetadata : System.Windows.PropertyChangedCallback -> System.Windows.PropertyMetadata

Public Sub New (propertyChangedCallback As PropertyChangedCallback)

Parameter

propertyChangedCallback

PropertyChangedCallback

Referensi ke implementasi handler yang akan dipanggil oleh sistem properti setiap kali nilai efektif properti berubah.

Contoh

static PropertyMetadata pm;

pm = new PropertyMetadata(new PropertyChangedCallback(OnCurrentReadingChanged));

PropertyMetadata(Object, PropertyChangedCallback)

Menginisialisasi instans PropertyMetadata baru kelas dengan nilai default dan PropertyChangedCallback referensi implementasi yang ditentukan.

public:
 PropertyMetadata(System::Object ^ defaultValue, System::Windows::PropertyChangedCallback ^ propertyChangedCallback);

public PropertyMetadata (object defaultValue, System.Windows.PropertyChangedCallback propertyChangedCallback);

new System.Windows.PropertyMetadata : obj * System.Windows.PropertyChangedCallback -> System.Windows.PropertyMetadata

Public Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback)

Parameter

defaultValue

Object

Nilai default properti dependensi, biasanya disediakan sebagai nilai dari beberapa jenis tertentu.

propertyChangedCallback

PropertyChangedCallback

Referensi ke implementasi handler yang akan dipanggil oleh sistem properti setiap kali nilai efektif properti berubah.

Pengecualian

ArgumentException

defaultValue tidak dapat diatur ke nilai UnsetValue.

Contoh

static PropertyMetadata pm;

pm = new PropertyMetadata(
    Double.NaN,
    new PropertyChangedCallback(OnCurrentReadingChanged)
);

Keterangan

Jenis nilai yang disediakan defaultValue harus cocok atau terkait dengan jenis yang ditentukan dalam pendaftaran asli properti dependensi tempat metadata ini akan diterapkan. Ketidakcocokan antara jenis nilai default metadata dan jenis properti dependensi yang diterapkannya bisa sulit untuk di-debug, karena ketidakcocokan tidak dapat dideteksi selama kompilasi (ketidakcocokan akan meningkatkan pengecualian run-time).

Meskipun ini adalah default per konstruktor tanpa parameter, defaultValue dari UnsetValue tidak dapat ditentukan. Mencoba melakukannya akan menimbulkan pengecualian.

PropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

Menginisialisasi instans PropertyMetadata baru kelas dengan nilai default dan panggilan balik yang ditentukan.

public:
 PropertyMetadata(System::Object ^ defaultValue, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback);

public PropertyMetadata (object defaultValue, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback);

new System.Windows.PropertyMetadata : obj * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback -> System.Windows.PropertyMetadata

Public Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)

Parameter

defaultValue

Object

Nilai default properti dependensi, biasanya disediakan sebagai nilai dari beberapa jenis tertentu.

propertyChangedCallback

PropertyChangedCallback

Referensi ke implementasi handler yang akan dipanggil oleh sistem properti setiap kali nilai efektif properti berubah.

coerceValueCallback

CoerceValueCallback

Referensi ke implementasi handler yang akan dipanggil setiap kali sistem properti memanggil CoerceValue(DependencyProperty) terhadap properti ini.

Pengecualian

ArgumentException

defaultValue tidak dapat diatur ke nilai UnsetValue.

Contoh

static PropertyMetadata pm;

pm = new PropertyMetadata(
    Double.NaN,
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading)
);

Keterangan

Jika Anda ingin menentukan CoerceValueCallback tetapi bukan PropertyChangedCallback, Anda dapat meneruskan nullpropertyChangedCallback untuk parameter .

Jenis nilai yang disediakan harus defaultValue cocok atau terkait dengan jenis yang ditentukan dalam pendaftaran asli properti dependensi tempat metadata ini akan diterapkan. Ketidakcocokan antara jenis nilai default metadata dan jenis properti dependensi yang diterapkannya bisa sulit untuk di-debug, karena ketidakcocokan tidak dapat dideteksi selama kompilasi (ketidakcocokan akan meningkatkan pengecualian run-time).

Meskipun ini adalah default per konstruktor tanpa parameter, defaultValue dari UnsetValue tidak dapat ditentukan. Mencoba melakukannya akan menimbulkan pengecualian.