ComponentSerializationService.SerializeAbsolute Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> unitPublic 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.
