ComponentSerializationService.SerializeAbsolute Methode

Definitie

Hiermee wordt het opgegeven object geserialiseerd, rekening met standaardeigenschapswaarden.

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)

Parameters

store
SerializationStore

De SerializationStore status waarvan de status value wordt geserialiseerd.

value
Object

Het object dat moet worden geserialiseerd.

Uitzonderingen

store of value is null.

store is gesloten of store is geen ondersteund type serialisatiearchief. Gebruik een winkel die wordt geretourneerd door CreateStore().

Opmerkingen

Standaardserialisatie, zoals geïmplementeerd via de Serialize methode, serialiseert alleen waarden die afwijken van de standaardstatus van het onderdeel. Dit biedt het meest compacte serialisatiemechanisme, maar gaat ervan uit dat een nieuw gemaakt object wordt gebruikt tijdens de deserialisatie. Als een bestaand object wordt gebruikt, is het resulterende gedeserialiseerde object niet gegarandeerd om de oorspronkelijke staat van het geserialiseerde object te dupliceren; de eigenschappen die standaardwaarden bevatten tijdens serialisatie, worden niet opnieuw ingesteld op de standaardwaarden tijdens de deserialisatie.

De SerializeAbsolute methode gebruikt deze snelkoppeling niet. Hiermee worden alle eigenschappen van het bronobject geserialiseerd, zodat deserialisatie alle eigenschappen van het object kan herstellen, ongeacht de standaardstatus.

Deze methode is met name handig voor het serialiseren van verzamelingen, omdat de volgorde van de samenstellende items in de verzameling kan veranderen. In dit geval is het veiligste proces voor het herstellen van de oorspronkelijke staat van de hele verzameling het overschrijven van alle items met alle oorspronkelijke eigenschapswaarden.

Van toepassing op

Zie ook