PropertyDescriptor.SetValue(Object, Object) Metode

  • Referensi

Definisi

Ruang nama:
System.ComponentModel
Rakitan:
System.ComponentModel.TypeConverter.dll
Rakitan:
System.dll
Rakitan:
netstandard.dll
Sumber:
PropertyDescriptor.cs
Sumber:
PropertyDescriptor.cs
Sumber:
PropertyDescriptor.cs

Saat ditimpa di kelas turunan, mengatur nilai komponen ke nilai yang berbeda.

public:
 abstract void SetValue(System::Object ^ component, System::Object ^ value);
public abstract void SetValue (object component, object value);
public abstract void SetValue (object? component, object? value);
abstract member SetValue : obj * obj -> unit
Public MustOverride Sub SetValue (component As Object, value As Object)

Parameter

component
Object

Komponen dengan nilai properti yang akan diatur.

value
Object

Nilai baru.

Keterangan

Biasanya, metode ini diimplementasikan melalui refleksi.

Metode ini membuat DesignerTransaction secara otomatis dalam urutan berikut:

  1. Metode ini memanggil IDesignerHost.CreateTransaction metode untuk membuat baru DesignerTransaction untuk mewakili perubahan.

  2. Metode memanggil IComponentChangeService.OnComponentChanging metode untuk menunjukkan bahwa transaksi telah dimulai dan perubahan akan terjadi.

  3. Metode mereset properti ke nilai yang ditentukan oleh urutan pemeriksaan metode ini.

  4. Metode memanggil IComponentChangeService.OnComponentChanged metode untuk menunjukkan bahwa perubahan telah terjadi.

  5. Metode memanggil DesignerTransaction.Commit untuk menunjukkan bahwa transaksi selesai.

Tujuan transaksi adalah untuk mendukung Undo dan Redo fungsionalitas.

Catatan Bagi Implementer

Ketika Anda mengambil alih metode ini, metode ini harus menetapkan nilai properti dengan memanggil metode "SetMyProperty" yang sesuai yang perlu Anda terapkan. Jika nilai yang ditentukan tidak valid, komponen harus melemparkan pengecualian, yang diteruskan. Anda harus merancang properti sehingga metode "GetMyProperty" (yang telah Anda terapkan) mengikuti metode "SetMyProperty" mengembalikan nilai yang diteruskan ketika metode "SetMyProperty" tidak memberikan pengecualian.

Berlaku untuk

Lihat juga