DesignerSerializationManager.PreserveNames Properti

Definisi

Ruang nama:

System.ComponentModel.Design.Serialization

Rakitan:

System.Windows.Forms.Design.dll

Mendapatkan atau menetapkan nilai yang menunjukkan apakah CreateInstance(Type, ICollection, String, Boolean) metode harus memeriksa keberadaan nama yang diberikan dalam kontainer.

public:
 property bool PreserveNames { bool get(); void set(bool value); };

public bool PreserveNames { get; set; }

member this.PreserveNames : bool with get, set

Public Property PreserveNames As Boolean

Nilai Properti

Boolean

true jika CreateInstance(Type, ICollection, String, Boolean) akan meneruskan nama komponen yang diberikan; false jika CreateInstance(Type, ICollection, String, Boolean) akan memeriksa keberadaan nama yang diberikan dalam kontainer. Default adalah true.

Pengecualian

InvalidOperationException

Properti ini diubah dari dalam sesi serialisasi.

Keterangan

Properti PreserveNames menentukan perilaku CreateInstance metode . Jika true, CreateInstance akan meneruskan nama komponen yang diberikan. Jika false, CreateInstance akan memeriksa keberadaan nama yang diberikan dalam kontainer. Jika nama tidak ada dalam kontainer, CreateInstance akan menggunakan nama yang diberikan. Jika nama memang ada dalam kontainer, CreateInstance akan meneruskan nilai null sebagai nama komponen saat menambahkannya ke kontainer, sehingga memberinya nama baru. Variasi kedua ini berguna untuk mengimplementasikan serializer yang selalu menduplikasi objek, daripada dengan asumsi objek tersebut tidak ada. Perintah tempel sering menggunakan jenis serializer ini.

Anda hanya dapat mengubah properti ini ketika Anda tidak berada dalam sesi serialisasi.

Lihat juga

• DesignerSerializationManager
• CreateInstance(Type, ICollection, String, Boolean)