Formatter Klasse

Definition

Namespace:

System.Runtime.Serialization

Assembly:

System.Runtime.Serialization.Formatters.dll

Quelle:

Formatter.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Stellt die Basisfunktionen für die Formatierungsprogramme der Common Language Runtime zur Serialisierung bereit.

public ref class Formatter abstract : System::Runtime::Serialization::IFormatter

[System.CLSCompliant(false)]
public abstract class Formatter : System.Runtime.Serialization.IFormatter

[<System.CLSCompliant(false)>]
type Formatter = class
    interface IFormatter

Public MustInherit Class Formatter
Implements IFormatter

Vererbung

Object

Formatter

Attribute

CLSCompliantAttribute

Implementiert

IFormatter

Hinweise

Formatter ist die abstract Basisklasse für alle Laufzeitserialisierungsformatierer und stellt einige Hilfsmethoden zum Implementieren der IFormatter Schnittstelle bereit. Verwaltet Formatter auch Warteschlangenobjekte für die Serialisierung und das Generieren von IDs pro Objekt.

Hinweise für Ausführende

Wenn Sie von erben Formatter, müssen Sie die folgenden Member überschreiben:

• Serialize(Stream, Object)

• Deserialize(Stream)

• WriteArray(Object, String, Type)

• WriteBoolean(Boolean, String)

• WriteByte(Byte, String)

• WriteChar(Char, String)

• WriteDateTime(DateTime, String)

• WriteDecimal(Decimal, String)

• WriteDouble(Double, String)

• WriteInt16(Int16, String)

• WriteInt32(Int32, String)

• WriteInt64(Int64, String)

• WriteObjectRef(Object, String, Type)

• WriteSByte(SByte, String)

• WriteSingle(Single, String)

• WriteTimeSpan(TimeSpan, String)

• WriteUInt16(UInt16, String)

• WriteUInt32(UInt32, String)

• WriteUInt64(UInt64, String)

• WriteValueType(Object, String, Type)

• SurrogateSelector

• Binder

• Context

Konstruktoren

Formatter()

Initialisiert eine neue Instanz der Formatter-Klasse.

Felder

m_idGenerator	Enthält den ObjectIDGenerator, der mit dem aktuellen Formatierungsprogramm verwendet wird.
m_objectQueue	Enthält eine Queue der Objekte, die noch serialisiert werden müssen.

Eigenschaften

Binder	Ruft beim Überschreiben in einer abgeleiteten Klasse den SerializationBinder ab, der mit dem aktuellen Formatierungsprogramm verwendet wird, oder legt diesen fest.
Context	Ruft beim Überschreiben in einer abgeleiteten Klasse den StreamingContext für die aktuelle Serialisierung ab oder legt diesen fest.
SurrogateSelector	Ruft beim Überschreiben in einer abgeleiteten Klasse den ISurrogateSelector ab, der mit dem aktuellen Formatierungsprogramm verwendet wird, oder legt diesen fest.

Methoden

Deserialize(Stream)	Veraltet. Deserialisiert beim Überschreiben in einer abgeleiteten Klasse den Stream, der beim Erstellen an das Formatierungsprogramm angefügt wurde, und erstellt dabei ein Objektdiagramm, das mit dem ursprünglich in den Stream serialisierten Diagramm identisch ist.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetNext(Int64)	Gibt aus der internen Arbeitswarteschlange des Formatierungsprogramms das nächste zu serialisierende Objekt zurück.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Schedule(Object)	Plant die spätere Serialisierung eines Objekts.
Serialize(Stream, Object)	Veraltet. Serialisiert beim Überschreiben in einer abgeleiteten Klasse das Objektdiagramm mit dem angegebenen Stammobjekt in den Stream, der bereits an das Formatierungsprogramm angefügt wurde.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
WriteArray(Object, String, Type)	Schreibt beim Überschreiben in einer abgeleiteten Klasse ein Array in den Stream, der bereits an das Formatierungsprogramm angefügt wurde.
WriteBoolean(Boolean, String)	Schreibt beim Überschreiben in einer abgeleiteten Klasse einen booleschen Wert in den Stream, der bereits an das Formatierungsprogramm angefügt wurde.
WriteByte(Byte, String)	Schreibt beim Überschreiben in einer abgeleiteten Klasse eine 8-Bit-Ganzzahl ohne Vorzeichen in den Stream, der bereits an das Formatierungsprogramm angefügt wurde.
WriteChar(Char, String)	Schreibt beim Überschreiben in einer abgeleiteten Klasse ein Unicode-Zeichen in den Stream, der bereits an das Formatierungsprogramm angefügt wurde.
WriteDateTime(DateTime, String)	Schreibt beim Überschreiben in einer abgeleiteten Klasse einen DateTime-Wert in den Stream, der bereits an das Formatierungsprogramm angefügt wurde.
WriteDecimal(Decimal, String)	Schreibt beim Überschreiben in einer abgeleiteten Klasse einen Decimal-Wert in den Stream, der bereits an das Formatierungsprogramm angefügt wurde.
WriteDouble(Double, String)	Schreibt beim Überschreiben in einer abgeleiteten Klasse eine Gleitkommazahl mit doppelter Genauigkeit in den Stream, der bereits an das Formatierungsprogramm angefügt wurde.
WriteInt16(Int16, String)	Schreibt beim Überschreiben in einer abgeleiteten Klasse eine 16-Bit-Ganzzahl mit Vorzeichen in den Stream, der bereits an das Formatierungsprogramm angefügt wurde.
WriteInt32(Int32, String)	Schreibt beim Überschreiben in einer abgeleiteten Klasse eine 32-Bit-Ganzzahl mit Vorzeichen in den Stream.
WriteInt64(Int64, String)	Schreibt beim Überschreiben in einer abgeleiteten Klasse eine 64-Bit-Ganzzahl mit Vorzeichen in den Stream.
WriteMember(String, Object)	Überprüft den Typ der empfangenen Daten und ruft die entsprechende Write-Methode auf, um den Schreibvorgang in den bereits an das Formatierungsprogramm angefügten Stream auszuführen.
WriteObjectRef(Object, String, Type)	Schreibt beim Überschreiben in einer abgeleiteten Klasse einen Objektverweis in den Stream, der bereits an das Formatierungsprogramm angefügt wurde.
WriteSByte(SByte, String)	Schreibt beim Überschreiben in einer abgeleiteten Klasse eine 8-Bit-Ganzzahl mit Vorzeichen in den Stream, der bereits an das Formatierungsprogramm angefügt wurde.
WriteSingle(Single, String)	Schreibt beim Überschreiben in einer abgeleiteten Klasse eine Gleitkommazahl mit einfacher Genauigkeit in den Stream, der bereits an das Formatierungsprogramm angefügt wurde.
WriteTimeSpan(TimeSpan, String)	Schreibt beim Überschreiben in einer abgeleiteten Klasse einen TimeSpan-Wert in den Stream, der bereits an das Formatierungsprogramm angefügt wurde.
WriteUInt16(UInt16, String)	Schreibt beim Überschreiben in einer abgeleiteten Klasse eine 16-Bit-Ganzzahl ohne Vorzeichen in den Stream, der bereits an das Formatierungsprogramm angefügt wurde.
WriteUInt32(UInt32, String)	Schreibt beim Überschreiben in einer abgeleiteten Klasse eine 32-Bit-Ganzzahl ohne Vorzeichen in den Stream, der bereits an das Formatierungsprogramm angefügt wurde.
WriteUInt64(UInt64, String)	Schreibt beim Überschreiben in einer abgeleiteten Klasse eine 64-Bit-Ganzzahl ohne Vorzeichen in den Stream, der bereits an das Formatierungsprogramm angefügt wurde.
WriteValueType(Object, String, Type)	Schreibt beim Überschreiben in einer abgeleiteten Klasse einen Wert vom angegebenen Typ in den Stream, der bereits an das Formatierungsprogramm angefügt wurde.

Weitere Informationen

• ObjectIDGenerator
• XML- und SOAP-Serialisierung