DesignerSerializationManager.PreserveNames Eigenschaft

Definition

Namespace:

System.ComponentModel.Design.Serialization

Assembly:

System.Windows.Forms.Design.dll

Ruft einen Wert ab, der angibt, ob das Vorhandensein eines angegebenen Namens im Container durch die CreateInstance(Type, ICollection, String, Boolean)-Methode überprüft werden soll, oder legt diesen fest.

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

Eigenschaftswert

Boolean

true, wenn CreateInstance(Type, ICollection, String, Boolean) den angegebenen Komponentennamen übergibt; false, wenn CreateInstance(Type, ICollection, String, Boolean) überprüft, ob der angegebenen Name im Container vorhanden ist. Der Standardwert ist true.

Ausnahmen

InvalidOperationException

Diese Eigenschaft wurde innerhalb einer Serialisierungssitzung geändert.

Hinweise

Die PreserveNames -Eigenschaft bestimmt das Verhalten der CreateInstance -Methode. Wenn trueübergeben CreateInstance wird, wird der angegebene Komponentenname übergeben. Wenn falseüberprüft, CreateInstance ob der angegebene Name im Container vorhanden ist. Wenn der Name nicht im Container vorhanden ist, CreateInstance wird der angegebene Name verwendet. Wenn der Name im Container vorhanden ist, CreateInstance wird ein NULL-Wert als Name einer Komponente übergeben, wenn sie dem Container hinzugefügt wird, wodurch sie einen neuen Namen erhält. Diese zweite Variante ist nützlich für die Implementierung eines Serialisierungsprogramms, das Objekte immer dupliziert, anstatt davon auszugehen, dass diese Objekte nicht vorhanden sind. Einfügebefehle verwenden häufig diese Art von Serialisierung.

Sie können diese Eigenschaft nur ändern, wenn Sie sich nicht in einer Serialisierungssitzung befinden.

Weitere Informationen

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