PropertyDescriptor.ResetValue(Object) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Saat ditimpa di kelas turunan, mengatur ulang nilai untuk properti komponen ini ke nilai default.
public:
abstract void ResetValue(System::Object ^ component);public abstract void ResetValue (object component);abstract member ResetValue : obj -> unitPublic MustOverride Sub ResetValue (component As Object)Parameter
- component
- Object
Komponen dengan nilai properti yang akan direset ke nilai default.
Keterangan
Biasanya, metode ini diimplementasikan melalui refleksi.
Metode ini menentukan nilai untuk mengatur ulang properti ke dalam urutan prioritas berikut:
Ada properti bayangan untuk properti ini.
Ada DefaultValueAttribute untuk properti ini.
Ada metode "ResetMyProperty" yang telah Anda terapkan, di mana "MyProperty" adalah nama properti yang Anda berikan padanya.
Metode ini membuat DesignerTransaction secara otomatis dalam urutan berikut:
Metode ini memanggil IDesignerHost.CreateTransaction metode untuk membuat baru DesignerTransaction untuk mewakili perubahan.
Metode memanggil IComponentChangeService.OnComponentChanging metode untuk menunjukkan bahwa transaksi telah dimulai dan perubahan akan terjadi.
Metode mereset properti ke nilai yang ditentukan oleh urutan pemeriksaan metode ini.
Metode memanggil IComponentChangeService.OnComponentChanged metode untuk menunjukkan bahwa perubahan telah terjadi.
Metode memanggil DesignerTransaction.Commit untuk menunjukkan bahwa transaksi selesai.
Tujuan transaksi adalah untuk mendukung Undo dan Redo fungsionalitas.
Catatan Bagi Implementer
Ketika ditimpa di kelas turunan, metode ini mencari DefaultValueAttribute. Jika menemukannya, nilai properti akan ditetapkan ke properti yang DefaultValueAttribute ditemukan. Jika metode ini tidak dapat menemukan DefaultValueAttribute, metode "ResetMyProperty" yang perlu Anda terapkan. Jika ini ditemukan, metode memanggilnya ResetValue(Object) . Jika ResetValue(Object) tidak dapat menemukan DefaultValueAttribute atau metode "ResetMyProperty" yang Anda terapkan, metode tersebut tidak melakukan operasi.
