Formatter Klasa

Definicja

Przestrzeń nazw:

System.Runtime.Serialization

Zestawy:

netstandard.dll, System.Runtime.Serialization.Formatters.dll

Źródło:

Formatter.cs

Przestroga

BinaryFormatter serialization is obsolete and should not be used. See https://aka.ms/binaryformatter for more information.

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Zapewnia podstawowe funkcje dla formaterów serializacji środowiska uruchomieniowego języka wspólnego.

C#

[System.CLSCompliant(false)]
[System.Obsolete("BinaryFormatter serialization is obsolete and should not be used. See https://aka.ms/binaryformatter for more information.", DiagnosticId="SYSLIB0011", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public abstract class Formatter : System.Runtime.Serialization.IFormatter

Dziedziczenie

Object

Formatter

Atrybuty

CLSCompliantAttribute ObsoleteAttribute

Implementuje

IFormatter

Uwagi

Formatter jest klasą bazową abstract dla wszystkich formaterów serializacji środowiska uruchomieniowego i udostępnia pewne metody pomocnicze do implementowania interfejsu IFormatter . Ponadto Formatter zarządza obiektami kolejkowania na potrzeby serializacji i generowania identyfikatorów na obiekt.

Uwagi dotyczące implementowania

Po dziedziczeniu z Formatterprogramu należy zastąpić następujące elementy członkowskie:

• 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

Konstruktory

Formatter()

Przestarzałe. Inicjuje nowe wystąpienie klasy Formatter.

Pola

m_idGenerator	Przestarzałe. ObjectIDGenerator Zawiera wartość używaną z bieżącym formaterem.
m_objectQueue	Przestarzałe. Queue Zawiera obiekt pozostawiony do serializacji.

Właściwości

Binder	Przestarzałe. Po przesłonięciu w klasie pochodnej pobiera lub ustawia SerializationBinder używane z bieżącym formatatorem.
Context	Przestarzałe. Po przesłonięciu w klasie pochodnej pobiera lub ustawia StreamingContext wartość używaną do bieżącej serializacji.
SurrogateSelector	Przestarzałe. Po przesłonięciu w klasie pochodnej pobiera lub ustawia ISurrogateSelector używane z bieżącym formatatorem.

Metody

Deserialize(Stream)	Po przesłonięciu w klasie pochodnej deserializuje strumień dołączony do formatatora, tworząc graf obiektów identyczny z grafem pierwotnie serializowanym w tym strumieniu.
Equals(Object)	Przestarzałe. Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Przestarzałe. Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetNext(Int64)	Przestarzałe. Zwraca następny obiekt do serializacji z wewnętrznej kolejki roboczej formatera.
GetType()	Przestarzałe. Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Przestarzałe. Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
Schedule(Object)	Przestarzałe. Planuje obiekt do późniejszej serializacji.
Serialize(Stream, Object)	Po przesłonięciu w klasie pochodnej serializuje graf obiektów z określonym katalogiem głównym do strumienia już dołączonego do formatatora.
ToString()	Przestarzałe. Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
WriteArray(Object, String, Type)	Przestarzałe. Gdy zastąpisz klasę pochodną, zapisuje tablicę do strumienia już dołączonego do formatatora.
WriteBoolean(Boolean, String)	Przestarzałe. Gdy zastąpisz klasę pochodną, zapisuje wartość logiczną do strumienia już dołączonego do formatatora.
WriteByte(Byte, String)	Przestarzałe. Gdy zastąpisz klasę pochodną, zapisuje 8-bitową niepodpisaną liczbę całkowitą do strumienia już dołączonego do formatera.
WriteChar(Char, String)	Przestarzałe. Gdy zastąpisz klasę pochodną, zapisuje znak Unicode do strumienia już dołączonego do formatatora.
WriteDateTime(DateTime, String)	Przestarzałe. Gdy zastąpisz klasę DateTime pochodną, zapisuje wartość do strumienia już dołączonego do formatatora.
WriteDecimal(Decimal, String)	Przestarzałe. Gdy zastąpisz klasę Decimal pochodną, zapisuje wartość do strumienia już dołączonego do formatatora.
WriteDouble(Double, String)	Przestarzałe. Po przesłonięciu w klasie pochodnej zapisuje liczbę zmiennoprzecinkową o podwójnej precyzji do strumienia już dołączonego do formatatora.
WriteInt16(Int16, String)	Przestarzałe. Po zastąpieniu w klasie pochodnej zapisuje 16-bitową liczbę całkowitą ze znakiem do strumienia już dołączonego do formatera.
WriteInt32(Int32, String)	Przestarzałe. Gdy zastąpisz klasę pochodną, zapisuje 32-bitową liczbę całkowitą ze znakiem do strumienia.
WriteInt64(Int64, String)	Przestarzałe. Gdy zastąpisz klasę pochodną, zapisuje 64-bitową liczbę całkowitą ze znakiem do strumienia.
WriteMember(String, Object)	Przestarzałe. Sprawdza typ odebranych danych i wywołuje odpowiednią Write metodę, aby wykonać zapis w strumieniu dołączonym już do formatującego.
WriteObjectRef(Object, String, Type)	Przestarzałe. Po zastąpieniu klasy pochodnej zapisuje odwołanie do obiektu do strumienia już dołączonego do formatatora.
WriteSByte(SByte, String)	Przestarzałe. Gdy zastąpisz klasę pochodną, zapisuje 8-bitową liczbę całkowitą ze znakiem do strumienia już dołączonego do formatera.
WriteSingle(Single, String)	Przestarzałe. Po przesłonięciu w klasie pochodnej zapisuje liczbę zmiennoprzecinkową o pojedynczej precyzji do strumienia już dołączonego do formatatora.
WriteTimeSpan(TimeSpan, String)	Przestarzałe. Gdy zastąpisz klasę TimeSpan pochodną, zapisuje wartość do strumienia już dołączonego do formatatora.
WriteUInt16(UInt16, String)	Przestarzałe. Po zastąpieniu w klasie pochodnej zapisuje 16-bitową liczbę całkowitą bez znaku do strumienia już dołączonego do formatera.
WriteUInt32(UInt32, String)	Przestarzałe. Po zastąpieniu w klasie pochodnej zapisuje 32-bitową liczbę całkowitą bez znaku do strumienia już dołączonego do formatera.
WriteUInt64(UInt64, String)	Przestarzałe. Po zastąpieniu w klasie pochodnej zapisuje 64-bitową liczbę całkowitą bez znaku do strumienia już dołączonego do formatera.
WriteValueType(Object, String, Type)	Przestarzałe. Po zastąpieniu w klasie pochodnej zapisuje wartość danego typu do strumienia już dołączonego do formatatora.

Dotyczy

Zobacz też

• ObjectIDGenerator
• Serializacja XML i SOAP