DependencyObject.SetValue Metode

Definisi

Ruang nama:

System.Windows

Rakitan:

WindowsBase.dll

Mengatur nilai lokal properti dependensi.

Overload

SetValue(DependencyProperty, Object)	Mengatur nilai lokal properti dependensi, yang ditentukan oleh pengidentifikasi properti dependensinya.
SetValue(DependencyPropertyKey, Object)	Mengatur nilai lokal properti dependensi baca-saja, yang ditentukan oleh pengidentifikasi DependencyPropertyKey properti dependensi.

SetValue(DependencyProperty, Object)

Mengatur nilai lokal properti dependensi, yang ditentukan oleh pengidentifikasi properti dependensinya.

public:
 void SetValue(System::Windows::DependencyProperty ^ dp, System::Object ^ value);

public void SetValue (System.Windows.DependencyProperty dp, object value);

member this.SetValue : System.Windows.DependencyProperty * obj -> unit

Public Sub SetValue (dp As DependencyProperty, value As Object)

Parameter

dp

DependencyProperty

Pengidentifikasi properti dependensi yang akan diatur.

value

Object

Nilai lokal baru.

Pengecualian

InvalidOperationException

Mencoba mengubah properti dependensi baca-saja, atau properti pada DependencyObjectyang disegel.

ArgumentException

value bukan tipe yang benar seperti yang terdaftar untuk properti dp.

Keterangan

Jika jenis yang disediakan tidak cocok dengan jenis yang dinyatakan untuk properti dependensi seperti yang awalnya didaftarkan, pengecualian akan dilemparkan. Parameter value harus selalu disediakan sebagai jenis yang sesuai.

Kondisi pengecualian berpotensi dipengaruhi oleh panggilan balik ValidateValueCallback yang ada pada pengidentifikasi properti dependensi dari properti dependensi yang ditetapkan. Jika tidak, nilai yang disediakan mungkin gagal dalam kondisi pemeriksaan jenis umum (misalnya, meneruskan string saat jenis aslinya adalah Ganda).

SetValue(DependencyPropertyKey, Object)

Mengatur nilai lokal properti dependensi baca-saja, yang ditentukan oleh pengidentifikasi DependencyPropertyKey properti dependensi.

public:
 void SetValue(System::Windows::DependencyPropertyKey ^ key, System::Object ^ value);

public void SetValue (System.Windows.DependencyPropertyKey key, object value);

member this.SetValue : System.Windows.DependencyPropertyKey * obj -> unit

Public Sub SetValue (key As DependencyPropertyKey, value As Object)

Parameter

key

DependencyPropertyKey

Pengidentifikasi DependencyPropertyKey properti yang akan diatur.

value

Object

Nilai lokal baru.

Contoh

Contoh berikut mendefinisikan properti dependensi baca-saja, bersama dengan public static readonlyDependencyProperty yang memberikan paparan baca-saja yang diperlukan kepada konsumen properti, dan mendapatkan aksesor untuk pembungkus CLR.

internal static readonly DependencyPropertyKey AquariumSizeKey = DependencyProperty.RegisterReadOnly(
  "AquariumSize",
  typeof(double),
  typeof(Aquarium),
  new PropertyMetadata(double.NaN)
);
public static readonly DependencyProperty AquariumSizeProperty =
  AquariumSizeKey.DependencyProperty;
public double AquariumSize
{
  get { return (double)GetValue(AquariumSizeProperty); }
}

Friend Shared ReadOnly AquariumSizeKey As DependencyPropertyKey = DependencyProperty.RegisterReadOnly("AquariumSize", GetType(Double), GetType(Aquarium), New PropertyMetadata(Double.NaN))
Public Shared ReadOnly AquariumSizeProperty As DependencyProperty = AquariumSizeKey.DependencyProperty
Public ReadOnly Property AquariumSize() As Double
    Get
        Return CDbl(GetValue(AquariumSizeProperty))
    End Get
End Property

Keterangan

Tanda tangan ini umumnya digunakan saat Anda menetapkan nilai untuk properti dependensi baca-saja yang ditentukan oleh kelas kustom Anda. Umumnya, SetValue hanya dipanggil dari jenis yang mendaftarkan properti dependensi tersebut, yang mengimplementasikan logika internal yang menyediakan nilai yang ditentukan untuk properti dependensi. Untuk informasi selengkapnya, lihat Read-Only Properti Dependensi.

Jika jenis yang disediakan tidak cocok dengan jenis yang dinyatakan untuk properti dependensi seperti yang awalnya didaftarkan, pengecualian akan dilemparkan. Parameter value harus selalu disediakan sebagai jenis yang sesuai. Kondisi pengecualian berpotensi dipengaruhi oleh panggilan balik ValidateValueCallback yang ada pada pengidentifikasi properti dependensi dari properti dependensi yang ditetapkan.