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, wobei Standardwerte für Eigenschaften angegeben werden.
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 Zustand, in den der Zustand value serialisiert wird.
- value
- Object
Das zu serialisierende Objekt.
Ausnahmen
store oder value ist null.
store wird geschlossen oder store ist kein unterstützter Serialisierungsspeichertyp. Verwenden Sie einen von CreateStore().
Hinweise
Standardmäßige Serialisierung, wie durch die Serialize Methode implementiert, serialisiert nur Werte, die sich vom Standardzustand der Komponente unterscheiden. Dies stellt den kompaktesten Serialisierungsmechanismus bereit, geht jedoch davon aus, dass ein neu erstelltes Objekt während der Deserialisierung verwendet wird. Wenn ein vorhandenes Objekt verwendet wird, wird das resultierende deserialisierte Objekt nicht garantiert, den ursprünglichen Zustand des serialisierten Objekts zu duplizieren. Die Eigenschaften, die Standardwerte während der Serialisierung enthalten, werden während der Deserialisierung nicht auf ihre Standardwerte zurückgesetzt.
Diese Verknüpfung wird von der SerializeAbsolute Methode nicht verwendet. Es serialisiert alle Eigenschaften des Quellobjekts, sodass die Deserialisierung alle Eigenschaften des Objekts unabhängig vom Standardzustand wiederherstellen kann.
Diese Methode eignet sich besonders für die Serialisierung von Sammlungen, da sich die Reihenfolge der Bestandteilelemente innerhalb der Auflistung ändern kann. In diesem Fall besteht der sicherste Prozess zum Wiederherstellen des ursprünglichen Zustands der gesamten Sammlung darin, alle Elemente mit allen ursprünglichen Eigenschaftswerten zu überschreiben.