Formatter Klasa

Definicja

Przestrzeń nazw:

System.Runtime.Serialization

Zestaw:

mscorlib.dll

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Udostępnia podstawowe funkcje formatujące serializacji środowiska uruchomieniowego języka wspólnego.

public ref class Formatter abstract : 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)>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Formatter = class
    interface IFormatter

Public MustInherit Class Formatter
Implements IFormatter

Dziedziczenie

Object

Formatter

Atrybuty

CLSCompliantAttribute SerializableAttribute ComVisibleAttribute

Implementuje

IFormatter

Uwagi

Formatter jest klasą bazową abstract dla wszystkich formaterów serializacji środowiska uruchomieniowego i udostępnia niektóre metody pomocnicze do implementowania interfejsu IFormatter . Obiekt Formatter zarządza również kolejkowaniem obiektów na potrzeby serializacji i generowania identyfikatorów na podstawie poszczególnych obiektów.

Notatki 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

Nazwa	Opis
Formatter()	Inicjuje nowe wystąpienie klasy Formatter.

Pola

Nazwa	Opis
m_idGenerator	ObjectIDGenerator Zawiera element używany z bieżącym formaterem.
m_objectQueue	Zawiera obiekt Queue pozostawiony do serializacji.

Właściwości

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

Metody

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

Zobacz też

• ObjectIDGenerator
• Serializacja XML i SOAP