DesignerSerializationManager.RecycleInstances Eigenschaft

Definition

Namespace:

System.ComponentModel.Design.Serialization

Assembly:

System.Windows.Forms.Design.dll

Ruft einen Wert ab, der angibt, ob CreateInstance(Type, ICollection, String, Boolean) immer eine neue Instanz eines Typs erstellt, oder legt diesen fest.

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

public bool RecycleInstances { get; set; }

member this.RecycleInstances : bool with get, set

Public Property RecycleInstances As Boolean

Eigenschaftswert

Boolean

true, wenn CreateInstance(Type, ICollection, String, Boolean) die vorhandene Instanz zurückgibt; false, wenn CreateInstance(Type, ICollection, String, Boolean) eine neue Instanz eines Typs erstellt. Der Standardwert ist false.

Ausnahmen

InvalidOperationException

Der Serialisierungs-Manager verfügt über eine aktive Serialisierungssitzung.

Hinweise

Wenn die RecycleInstances -Eigenschaft lautetfalse, erstellt die CreateInstance -Methode immer eine neue instance eines Typs. Wenn RecycleInstances ist true, CreateInstance durchsucht zuerst die Namenstabelle und den Container nach einem Objekt mit demselben Namen. Wenn ein solches Objekt vorhanden ist und vom gleichen Typ ist, CreateInstance gibt das vorhandene instance zurück. Diese zweite Variante ist nützlich, um einen Serialisierer zu implementieren, der den Serialisierungsstatus auf eine vorhandene Gruppe von Objekten anwendet, anstatt immer eine neue Struktur zu erstellen. Der Befehl Rückgängig verwendet häufig diese Art von Serialisierung.

Wenn die RecycleInstances -Eigenschaft ist true, ändert die ValidateRecycledTypes -Eigenschaft das Verhalten von abhängig von CreateInstance den Typen der beiden Objekte weiter.

Weitere Informationen

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