ComponentSerializationService.SerializeAbsolute Methode

Definition

Namespace:

System.ComponentModel.Design.Serialization

Assembly:

System.ComponentModel.TypeConverter.dll

Quelle:

ComponentSerializationService.cs

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

ArgumentNullException

store oder value ist null.

InvalidOperationException

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.

Weitere Informationen

• SerializationStore
• MemberDescriptor
• Serialize(SerializationStore, Object)
• SerializeMember(SerializationStore, Object, MemberDescriptor)
• SerializeMemberAbsolute(SerializationStore, Object, MemberDescriptor)