Formatter Třída

Definice

Obor názvů:

System.Runtime.Serialization

Sestavení:

System.Runtime.Serialization.Formatters.dll

Zdroj:

Formatter.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Poskytuje základní funkce pro common language runtime serializace formátování.

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

Dědičnost

Object

Formatter

Atributy

CLSCompliantAttribute

Implementuje

IFormatter

Poznámky

Formatter abstract je základní třída pro všechny moduly formátování serializace modulu runtime a poskytuje některé pomocné metody pro implementaci IFormatter rozhraní. Také Formatter spravuje objekty řazení do fronty pro serializaci a generování ID na základě jednotlivých objektů.

Poznámky pro implementátory

Pokud dědíte z Formatter, musíte přepsat následující členy:

• 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()

Inicializuje novou instanci Formatter třídy.

Pole

m_idGenerator	Obsahuje použitý s ObjectIDGenerator aktuálním formátovačem.
m_objectQueue	Queue Obsahuje objekty zbývající k serializaci.

Vlastnosti

Binder	Při přepsání v odvozené třídě získá nebo nastaví SerializationBinder použitý s aktuálním formátovačem.
Context	Při přepsání v odvozené třídě, získá nebo nastaví StreamingContext použité pro aktuální serializaci.
SurrogateSelector	Při přepsání v odvozené třídě získá nebo nastaví ISurrogateSelector použitý s aktuálním formátovačem.

Metody

Deserialize(Stream)	Zastaralé. Při přepsání v odvozené třídě deserializuje datový proud připojený k formátovacímu modulu při jeho vytvoření a vytvoří graf objektů identických s grafem původně serializovaným do tohoto datového proudu.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetNext(Int64)	Vrátí další objekt k serializaci z interní pracovní fronty formátovače.
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
Schedule(Object)	Naplánuje objekt pro pozdější serializaci.
Serialize(Stream, Object)	Zastaralé. Při přepsání v odvozené třídě serializuje graf objektů se zadaným kořenem na stream již připojený k formátovacímu modulu.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
WriteArray(Object, String, Type)	Při přepsání v odvozené třídě zapíše pole do datového proudu, který je již připojen k formátovacímu modulu.
WriteBoolean(Boolean, String)	Při přepsání v odvozené třídě zapíše logickou hodnotu do datového proudu, který je již připojen k formátovacímu modulu.
WriteByte(Byte, String)	Při přepsání v odvozené třídě zapíše 8bitové celé číslo bez znaménka do datového proudu, který je již připojen k formátovacímu modulu.
WriteChar(Char, String)	Při přepsání v odvozené třídě zapíše znak Unicode do datového proudu, který je již připojen k formátovacímu modulu.
WriteDateTime(DateTime, String)	Při přepsání v odvozené třídě zapíše DateTime hodnotu do datového proudu, který je již připojen k formátovacímu modulu.
WriteDecimal(Decimal, String)	Při přepsání v odvozené třídě zapíše Decimal hodnotu do datového proudu, který je již připojen k formátovacímu modulu.
WriteDouble(Double, String)	Při přepsání v odvozené třídě zapíše číslo s plovoucí desetinou čárkou s dvojitou přesností do datového proudu, který je již připojen k formátovacímu modulu.
WriteInt16(Int16, String)	Při přepsání v odvozené třídě zapíše 16bitové celé číslo se znaménkem do datového proudu, který je již připojen k formatteru.
WriteInt32(Int32, String)	Při přepsání v odvozené třídě zapíše do datového proudu celé 32bitové signedé číslo.
WriteInt64(Int64, String)	Při přepsání v odvozené třídě zapíše do datového proudu celé číslo se 64bitovým signýmým kódem.
WriteMember(String, Object)	Zkontroluje typ přijatých dat a zavolá příslušnou Write metodu k provedení zápisu do datového proudu, který je již připojen k formátovacímu modulu.
WriteObjectRef(Object, String, Type)	Při přepsání v odvozené třídě zapíše odkaz na objekt na stream již připojený k formátovacímu modulu.
WriteSByte(SByte, String)	Při přepsání v odvozené třídě zapíše 8bitové celé číslo se znaménkem do datového proudu, který je již připojen k formátovacímu modulu.
WriteSingle(Single, String)	Při přepsání v odvozené třídě zapíše číslo s plovoucí desetinou čárkou s jednou přesností na datový proud, který je již připojen k formátovacímu modulu.
WriteTimeSpan(TimeSpan, String)	Při přepsání v odvozené třídě zapíše TimeSpan hodnotu do datového proudu, který je již připojen k formátovacímu modulu.
WriteUInt16(UInt16, String)	Při přepsání v odvozené třídě zapíše 16bitové celé číslo bez znaménka do datového proudu, který je již připojen k formátovacímu modulu.
WriteUInt32(UInt32, String)	Při přepsání v odvozené třídě zapíše 32bitové celé číslo bez znaménka do datového proudu, který je již připojen k formátovacímu modulu.
WriteUInt64(UInt64, String)	Při přepsání v odvozené třídě zapíše 64bitové celé číslo bez znaménka do datového proudu, který je již připojen k formátovacímu modulu.
WriteValueType(Object, String, Type)	Při přepsání v odvozené třídě zapíše hodnotu daného typu do datového proudu, který je již připojen k formátovacímu modulu.

Viz také

• ObjectIDGenerator
• Serializace XML a SOAP