Freigeben über


ComponentSerializationService.SerializeAbsolute Methode

Definition

Serialisiert das angegebene Objekt unter Berücksichtigung von Standardeigenschaftswerten.

public:
 abstract void SerializeAbsolute(System::ComponentModel::Design::Serialization::SerializationStore ^ store, System::Object ^ value);
public abstract void SerializeAbsolute (System.ComponentModel.Design.Serialization.SerializationStore store, object value);
abstract member SerializeAbsolute : System.ComponentModel.Design.Serialization.SerializationStore * obj -> unit
Public MustOverride Sub SerializeAbsolute (store As SerializationStore, value As Object)

Parameter

store
SerializationStore

Der SerializationStore, in den der Zustand von value serialisiert wird.

value
Object

Das zu serialisierende Objekt.

Ausnahmen

store oder value ist null.

store wird geschlossen, oder store ist kein unterstützter Typ des Serialisierungsspeichers. Verwenden Sie einen von CreateStore() zurückgegebenen Speicher.

Hinweise

Die Standardserialisierung, wie sie über die Serialize -Methode implementiert wird, serialisiert nur Werte, die sich vom Standardzustand der Komponente unterscheiden. Dies bietet den kompaktesten Serialisierungsmechanismus, geht jedoch davon aus, dass ein neu erstelltes Objekt während der Deserialisierung verwendet wird. Wenn ein vorhandenes Objekt verwendet wird, wird nicht garantiert, dass das resultierende deserialisierte Objekt den ursprünglichen Zustand des serialisierten Objekts dupliziert. Die Eigenschaften, die Standardwerte während der Serialisierung enthalten, werden während der Deserialisierung nicht auf ihre Standardwerte zurückgesetzt.

Die SerializeAbsolute -Methode verwendet diese Verknüpfung nicht. Es serialisiert alle Eigenschaften des Quellobjekts, damit die Deserialisierung alle Eigenschaften des Objekts wiederherstellen kann, unabhängig vom Standardzustand.

Diese Methode ist besonders nützlich für die Serialisierung von Sammlungen, da sich die Reihenfolge der konstituierenden Elemente innerhalb der Auflistung ändern kann. In diesem Fall besteht der sicherste Prozess zum Wiederherstellen des ursprünglichen Zustands der gesamten Auflistung darin, alle Elemente mit allen ursprünglichen Eigenschaftswerten zu überschreiben.

Gilt für:

Weitere Informationen