DesignerSerializationManager.PreserveNames Właściwość

Definicja

Przestrzeń nazw:

System.ComponentModel.Design.Serialization

Zestaw:

System.Windows.Forms.Design.dll

Pobiera lub ustawia wartość wskazującą, czy CreateInstance(Type, ICollection, String, Boolean) metoda powinna sprawdzić obecność podanej nazwy w kontenerze.

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

Wartość właściwości

Boolean

true jeśli CreateInstance(Type, ICollection, String, Boolean) przekaże daną nazwę składnika; false jeśli CreateInstance(Type, ICollection, String, Boolean) sprawdzi obecność podanej nazwy w kontenerze. Wartość domyślna to true.

Wyjątki

InvalidOperationException

Ta właściwość została zmieniona z poziomu sesji serializacji.

Uwagi

Właściwość PreserveNames określa zachowanie CreateInstance metody. Jeśli trueparametr przekaże CreateInstance daną nazwę składnika. Jeśli falseprogram CreateInstance sprawdzi obecność podanej nazwy w kontenerze. Jeśli nazwa nie istnieje w kontenerze, CreateInstance użyje podanej nazwy. Jeśli nazwa istnieje w kontenerze, CreateInstance przekaże wartość null jako nazwę składnika podczas dodawania jej do kontenera, dając mu nową nazwę. Ta druga odmiana jest przydatna do implementowania serializatora, który zawsze duplikuje obiekty, zamiast zakładać, że te obiekty nie istnieją. Wklej polecenia często używają tego typu serializatora.

Tę właściwość można zmienić tylko wtedy, gdy nie jesteś w sesji serializacji.

Zobacz też

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