Formatter クラス

定義

名前空間:

System.Runtime.Serialization

アセンブリ:

mscorlib.dll

重要

この API は CLS 準拠ではありません。

共通言語ランタイムシリアル化フォーマッタの基本機能を提供します。

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

継承

Object

Formatter

属性

CLSCompliantAttribute SerializableAttribute ComVisibleAttribute

実装

IFormatter

注釈

Formatter は、すべてのランタイム シリアル化フォーマッタの abstract 基本クラスであり、 IFormatter インターフェイスを実装するためのヘルパー メソッドをいくつか提供します。 Formatterでは、シリアル化のためのオブジェクトのキューと、オブジェクトごとに ID を生成する処理も管理されます。

注意 (実装者)

Formatterから継承する場合は、次のメンバーをオーバーライドする必要があります。

• 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

コンストラクター

名前	説明
Formatter()	Formatter クラスの新しいインスタンスを初期化します。

フィールド

名前	説明
m_idGenerator	現在のフォーマッタで使用される ObjectIDGenerator を格納します。
m_objectQueue	シリアル化するために残されたオブジェクトの Queue を格納します。

プロパティ

名前	説明
Binder	派生クラスでオーバーライドされると、現在のフォーマッタで使用される SerializationBinder を取得または設定します。
Context	派生クラスでオーバーライドされると、現在のシリアル化に使用される StreamingContext を取得または設定します。
SurrogateSelector	派生クラスでオーバーライドされると、現在のフォーマッタで使用される ISurrogateSelector を取得または設定します。

メソッド

名前	説明
Deserialize(Stream)	派生クラスでオーバーライドされると、フォーマッタの作成時にアタッチされたストリームを逆シリアル化し、そのストリームに最初にシリアル化されたグラフと同じオブジェクトのグラフを作成します。
Equals(Object)	指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetNext(Int64)	フォーマッタの内部作業キューから、シリアル化する次のオブジェクトを返します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
Schedule(Object)	後でシリアル化できるようにオブジェクトをスケジュールします。
Serialize(Stream, Object)	派生クラスでオーバーライドされると、指定したルートを持つオブジェクトのグラフを、フォーマッタに既にアタッチされているストリームにシリアル化します。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
WriteArray(Object, String, Type)	派生クラスでオーバーライドされると、フォーマッタに既にアタッチされているストリームに配列を書き込みます。
WriteBoolean(Boolean, String)	派生クラスでオーバーライドされると、フォーマッタに既にアタッチされているストリームにブール値を書き込みます。
WriteByte(Byte, String)	派生クラスでオーバーライドされると、フォーマッタに既にアタッチされているストリームに 8 ビット符号なし整数を書き込みます。
WriteChar(Char, String)	派生クラスでオーバーライドされると、フォーマッタに既にアタッチされているストリームに Unicode 文字を書き込みます。
WriteDateTime(DateTime, String)	派生クラスでオーバーライドされると、フォーマッタに既にアタッチされているストリームに DateTime 値を書き込みます。
WriteDecimal(Decimal, String)	派生クラスでオーバーライドされると、フォーマッタに既にアタッチされているストリームに Decimal 値を書き込みます。
WriteDouble(Double, String)	派生クラスでオーバーライドされると、フォーマッタに既にアタッチされているストリームに倍精度浮動小数点数を書き込みます。
WriteInt16(Int16, String)	派生クラスでオーバーライドされると、フォーマッタに既にアタッチされているストリームに 16 ビット符号付き整数を書き込みます。
WriteInt32(Int32, String)	派生クラスでオーバーライドされると、32 ビット符号付き整数をストリームに書き込みます。
WriteInt64(Int64, String)	派生クラスでオーバーライドされると、64 ビット符号付き整数をストリームに書き込みます。
WriteMember(String, Object)	受信したデータの種類を検査し、適切な Write メソッドを呼び出して、フォーマッタに既にアタッチされているストリームへの書き込みを実行します。
WriteObjectRef(Object, String, Type)	派生クラスでオーバーライドされると、フォーマッタに既にアタッチされているストリームへのオブジェクト参照を書き込みます。
WriteSByte(SByte, String)	派生クラスでオーバーライドされると、フォーマッタに既にアタッチされているストリームに 8 ビット符号付き整数を書き込みます。
WriteSingle(Single, String)	派生クラスでオーバーライドされると、フォーマッタに既にアタッチされているストリームに単精度浮動小数点数を書き込みます。
WriteTimeSpan(TimeSpan, String)	派生クラスでオーバーライドされると、フォーマッタに既にアタッチされているストリームに TimeSpan 値を書き込みます。
WriteUInt16(UInt16, String)	派生クラスでオーバーライドされると、フォーマッタに既にアタッチされているストリームに 16 ビット符号なし整数を書き込みます。
WriteUInt32(UInt32, String)	派生クラスでオーバーライドされると、フォーマッタに既にアタッチされているストリームに 32 ビット符号なし整数を書き込みます。
WriteUInt64(UInt64, String)	派生クラスでオーバーライドされると、フォーマッタに既にアタッチされているストリームに 64 ビット符号なし整数を書き込みます。
WriteValueType(Object, String, Type)	派生クラスでオーバーライドされると、指定された型の値を、フォーマッタに既にアタッチされているストリームに書き込みます。

こちらもご覧ください

• ObjectIDGenerator
• XML と SOAP のシリアル化