SerializationContext Klasse

Definition

Diese Klasse definiert den Kontext eines Serialisierungsvorgangs.This class defines the context of a serialization operation. Der Kontext, der an jeden teilnehmenden Serialisierer übergeben wird, um Informationen bereitzustellen, die Sie verwenden können, und der Kontext speichert die serialisierungsergebnisse, die von jedem teilnehmenden serialisierungsproThe context passed to each participating serializers to provide information that they may use, and the context stores serialization results collected from each participating serializers.

public ref class SerializationContext sealed
public sealed class SerializationContext
type SerializationContext = class
Public NotInheritable Class SerializationContext
Vererbung
SerializationContext

Konstruktoren

SerializationContext(DomainXmlSerializerDirectory)

Erstellen Sie einen Serialisierungskontext ohne Quell-/Zielspeicherort-Informationen.Create a serialization context with no source/destination location information.

SerializationContext(DomainXmlSerializerDirectory, String)

Erstellen Sie einen Serialisierungskontext mit dem angegebenen Quell-/Zielspeicherort.Create a serialization context with given source/destination location.

SerializationContext(DomainXmlSerializerDirectory, String, SerializationResult)

Erstellen Sie einen Serialisierungskontext mit dem angegebenen Quell-/Zielspeicherort und seralizationresult.Create a serialization context with given source/destination location and SeralizationResult.

Felder

TransactionContextKey

Der eindeutige Schlüssel, der zum Identifizieren der SerializationContext-Instanzen im transaktioncontext-Eigenschaften Behälter verwendet wird.Unique key used to identify SerializationContext instances in the TransactionContext property bag

Eigenschaften

Directory

Während der Serialisierung/Deserialisierung muss eine serialisierungsprodukt-Instanz bei der Serialisierung und Deserialisierung nach anderen serialisiererinstanzen suchen.A serializer instance needs to look up for other serializer instances during serialization/deserialization, so this directory provides the lookup service.

Item[String]

Indexer, um auf in diesem Kontext gespeicherte Eigenschaften zuzugreifen.Indexer to access properties stored in this context. Der Eigenschaftsname wird durch einen Ordinalzeichenfolgenvergleich mit Groß-/KleinschreibungThe property name is compared by case-sensitive ordinal string comparison. Wenn bereits eine Eigenschaft im Kontext vorhanden ist, wird der alte Wert durch Festlegen des neuen Werts mit dem neuen Wert überschrieben.If a property already exists in the context, setting it will override the old value with the new value. Wenn eine Eigenschaft nicht im Kontext vorhanden ist, wird der Wert NULL zurückgegeben. Wenn Sie also eine Eigenschaft auf NULL festlegen, wird Sie aus dem Kontext entfernt (d. h., NULL-Werte und nicht vorhandene Werte sind nicht unterscheidbar).If a property doesn't exist in the context, getting it will return null, therefore setting a property to null will remove it from the context (i.e. null and non-existing values are not distinguishable).

Location

Beim Lesevorgang ist dies der Speicherort der Quelle. beim Schreibvorgang ist dies der Ziel Speicherort.In read operation, this is the source's location; in write operation, this is the destination location. In der Regel handelt es sich hierbei um einen Dateipfad, aber es kann auch ein anderes Format geben, abhängig von der zugrunde liegenden Quelle bzw. dem Ziel.Usually this is a file path, but it can be other format as well, depending on the underlying source/destination. Sie kann auch NULL sein, wenn der Speicherort nicht verfügbar ist, z. b. das Serialisieren in einen Zeichen folgen Puffer.It can be null as well if the location is not available, e.g. serializing to a string buffer.

Result

Dabei handelt es sich um das von allen Serialisierungsprogrammen erfasste serialisierungsergebnis, das an der aktuellen Serialisierung teilnimmtThis is the SerializationResult collected from all serializers participating in the current serialization operation.

WriteOptionalPropertiesWithDefaultValue

Gibt an, ob optionale Eigenschaften mit Standardwert während der Serialisierung geschrieben werden sollen.Whether optional properties with default value should be written out during serialization.

Gilt für: