Formatter Klasse

Definition

Namespace:
System.Runtime.Serialization
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Wichtig

Diese API ist nicht CLS-kompatibel.

Stellt Basisfunktionen für die Serialisierungsformatierer der Common Language Runtime bereit.

public ref class Formatter abstract : System::Runtime::Serialization::IFormatter
[System.CLSCompliant(false)]
[System.Serializable]
public abstract class Formatter : System.Runtime.Serialization.IFormatter
[System.CLSCompliant(false)]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Formatter : System.Runtime.Serialization.IFormatter
[System.CLSCompliant(false)]
public abstract class Formatter : System.Runtime.Serialization.IFormatter
[<System.CLSCompliant(false)>]
[<System.Serializable>]
type Formatter = class
    interface IFormatter
[<System.CLSCompliant(false)>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Formatter = class
    interface IFormatter
[<System.CLSCompliant(false)>]
type Formatter = class
    interface IFormatter
Public MustInherit Class Formatter
Implements IFormatter
Vererbung
Object
Formatter
Attribute
CLSCompliantAttribute SerializableAttribute ComVisibleAttribute
Implementiert
IFormatter

Hinweise

Formatter ist die abstract Basisklasse für alle Runtime-Serialisierungsformatierer und stellt einige Hilfsmethoden für die Implementierung der IFormatter Schnittstelle bereit. Außerdem verwaltet Formatter das Queuing von Objekten für die Serialisierung und das Generieren von IDs auf Basis jedes Objekts.

Hinweise für Ausführende

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

Konstruktoren

Name Beschreibung
Formatter()

Initialisiert eine neue Instanz der Formatter-Klasse.

Felder

Name Beschreibung
m_idGenerator

Enthält den ObjectIDGenerator mit dem aktuellen Formatierer verwendeten Wert.
m_objectQueue

Enthält eine Queue der Objekte, die links serialisiert werden sollen.

Eigenschaften

Name Beschreibung
Binder

Wenn sie in einer abgeleiteten Klasse überschrieben werden, wird der SerializationBinder verwendete Wert mit dem aktuellen Formatierer abgerufen oder festgelegt.
Context

Wenn sie in einer abgeleiteten Klasse überschrieben werden, ruft die für die aktuelle Serialisierung verwendete Klasse ab oder legt sie StreamingContext fest.
SurrogateSelector

Wenn sie in einer abgeleiteten Klasse überschrieben werden, wird der ISurrogateSelector verwendete Wert mit dem aktuellen Formatierer abgerufen oder festgelegt.

Methoden

Name Beschreibung
Deserialize(Stream)

Wenn er in einer abgeleiteten Klasse überschrieben wird, wird der an den Formatierer angefügte Datenstrom beim Erstellen des Datenstroms deserialisiert, wodurch ein Diagramm mit Objekten erstellt wird, die mit dem diagramm identisch sind, das ursprünglich in diesen Datenstrom serialisiert wurde.
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetNext(Int64)

Gibt das nächste zu serialisierende Objekt aus der internen Arbeitswarteschlange des Formatierers zurück.
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
Schedule(Object)

Plant ein Objekt für die spätere Serialisierung.
Serialize(Stream, Object)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, serialisiert das Diagramm von Objekten mit dem angegebenen Stamm an den Stream, der bereits an den Formatierer angefügt ist.
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
WriteArray(Object, String, Type)

Wenn eine abgeleitete Klasse überschrieben wird, wird ein Array in den Datenstrom geschrieben, der bereits an den Formatierer angefügt ist.
WriteBoolean(Boolean, String)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein boolescher Wert in den Stream geschrieben, der bereits an den Formatierer angefügt ist.
WriteByte(Byte, String)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird eine 8-Bit-ganzzahl ohne Vorzeichen in den Stream geschrieben, der bereits an den Formatierer angefügt ist.
WriteChar(Char, String)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Unicode-Zeichen in den Stream geschrieben, der bereits an den Formatierer angefügt ist.
WriteDateTime(DateTime, String)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein DateTime Wert in den Stream geschrieben, der bereits an den Formatierer angefügt ist.
WriteDecimal(Decimal, String)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Decimal Wert in den Stream geschrieben, der bereits an den Formatierer angefügt ist.
WriteDouble(Double, String)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird eine Gleitkommazahl mit doppelter Genauigkeit in den Datenstrom geschrieben, der bereits an den Formatierer angefügt ist.
WriteInt16(Int16, String)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird eine 16-Bit-ganzzahlige Vorzeichen in den Stream geschrieben, der bereits an den Formatierer angefügt ist.
WriteInt32(Int32, String)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird eine 32-Bit-Ganzzahl mit Vorzeichen in den Datenstrom geschrieben.
WriteInt64(Int64, String)

Wenn eine abgeleitete Klasse überschrieben wird, wird eine 64-Bit-Ganzzahl mit Vorzeichen in den Datenstrom geschrieben.
WriteMember(String, Object)

Überprüft den Typ der empfangenen Daten und ruft die entsprechende Write Methode auf, um den Schreibvorgang in den Bereits an den Formatierer angefügten Datenstrom auszuführen.
WriteObjectRef(Object, String, Type)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Objektverweis auf den Stream geschrieben, der bereits an den Formatierer angefügt ist.
WriteSByte(SByte, String)

Wenn eine abgeleitete Klasse überschrieben wird, wird eine 8-Bit-ganzzahlige Vorzeichen in den Stream geschrieben, der bereits an den Formatierer angefügt ist.
WriteSingle(Single, String)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird eine Gleitkommazahl mit einfacher Genauigkeit in den Stream geschrieben, der bereits an den Formatierer angefügt ist.
WriteTimeSpan(TimeSpan, String)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein TimeSpan Wert in den Stream geschrieben, der bereits an den Formatierer angefügt ist.
WriteUInt16(UInt16, String)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird eine 16-Bit-ganzzahl ohne Vorzeichen in den Stream geschrieben, der bereits an den Formatierer angefügt ist.
WriteUInt32(UInt32, String)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird eine 32-Bit-ganzzahl ohne Vorzeichen in den Stream geschrieben, der bereits an den Formatierer angefügt ist.
WriteUInt64(UInt64, String)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird eine 64-Bit-ganzzahl ohne Vorzeichen in den Stream geschrieben, der bereits an den Formatierer angefügt ist.
WriteValueType(Object, String, Type)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert des angegebenen Typs in den Stream geschrieben, der bereits an den Formatierer angefügt ist.

Gilt für:

Weitere Informationen