Formatter Třída

Definice

Obor názvů:

System.Runtime.Serialization

Sestavení:

System.Runtime.Serialization.Formatters.dll

Balíček:

System.Runtime.Serialization.Formatters v11.0.0-preview.5.26302.115

Zdroj:

Formatter.cs

Upozornění

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

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Poskytuje základní funkce pro formátovací moduly serializace modulu CLR (Common Language Runtime).

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

[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

[<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}")>]
type Formatter = class
    interface IFormatter

Public MustInherit Class Formatter
Implements IFormatter

Dědičnost

Object

Formatter

Atributy

CLSCompliantAttribute ObsoleteAttribute

Implementuje

IFormatter

Poznámky

Formatter abstract je základní třída pro všechny moduly runtime serializace formátování a poskytuje některé pomocné metody pro implementaci IFormatter rozhraní. Spravuje Formatter také objekty front pro serializaci a generování ID na základě objektu.

Poznámky pro implementátory

Když 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

Name	Description
Formatter()	Zastaralé. Inicializuje novou instanci Formatter třídy.

Pole

Name	Description
m_idGenerator	Zastaralé. ObjectIDGenerator Obsahuje použitý s aktuálním formátovačem.
m_objectQueue	Zastaralé. Queue Obsahuje objekty, které zbývá serializovat.

Vlastnosti

Name	Description
Binder	Zastaralé. Při přepsání v odvozené třídě získá nebo nastaví SerializationBinder použité s aktuálním formátovacím objektem.
Context	Zastaralé. Při přepsání v odvozené třídě získá nebo nastaví StreamingContext použité pro aktuální serializace.
SurrogateSelector	Zastaralé. Při přepsání v odvozené třídě získá nebo nastaví ISurrogateSelector použité s aktuálním formátovacím objektem.

Metody

Name	Description
Deserialize(Stream)	Při přepsání v odvozené třídě deserializuje datový proud připojený k formátovači při jeho vytvoření a vytvoří graf objektů identický s grafem původně serializovaný do tohoto datového proudu.
GetNext(Int64)	Zastaralé. Vrátí další objekt, který se má serializovat, z interní pracovní fronty formátovače.
Schedule(Object)	Zastaralé. Naplánuje objekt pro pozdější serializaci.
Serialize(Stream, Object)	Při přepsání v odvozené třídě serializuje graf objektů se zadaným kořenem do datového proudu, který je již připojen k formátovacímu modulu.
WriteArray(Object, String, Type)	Zastaralé. 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)	Zastaralé. 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)	Zastaralé. 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)	Zastaralé. 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)	Zastaralé. 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)	Zastaralé. 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)	Zastaralé. Při přepsání v odvozené třídě zapíše číslo s plovoucí desetinnou čárkou s dvojitou přesností na datový proud, který je již připojen k formátovacímu modulu.
WriteInt16(Int16, String)	Zastaralé. Při přepsání v odvozené třídě zapíše 16bitové podepsané celé číslo do datového proudu, který je již připojen k formátovacímu modulu.
WriteInt32(Int32, String)	Zastaralé. Při přepsání v odvozené třídě zapíše 32bitové podepsané celé číslo do datového proudu.
WriteInt64(Int64, String)	Zastaralé. Při přepsání v odvozené třídě zapíše 64bitové podepsané celé číslo do datového proudu.
WriteMember(String, Object)	Zastaralé. Zkontroluje typ přijatých dat a zavolá příslušnou Write metodu pro provedení zápisu do datového proudu, který je již připojen k formátovacímu modulu.
WriteObjectRef(Object, String, Type)	Zastaralé. Při přepsání v odvozené třídě, zapíše objekt odkaz na datový proud již připojen k formatter.
WriteSByte(SByte, String)	Zastaralé. 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)	Zastaralé. Při přepsání v odvozené třídě zapíše číslo s plovoucí desetinnou čárkou s jednoduchou přesností na datový proud, který je již připojen k formátovacímu modulu.
WriteTimeSpan(TimeSpan, String)	Zastaralé. 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)	Zastaralé. 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)	Zastaralé. 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)	Zastaralé. 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)	Zastaralé. 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