次の方法で共有


BinaryFormatter.Serialize メソッド (Stream, Object, Header )

オブジェクト、または先頭 (ルート) を指定したオブジェクト グラフを、指定したヘッダーを結び付けて、指定したストリームにシリアル化します。

Overloads Public Overridable Sub Serialize( _
   ByVal serializationStream As Stream, _   ByVal graph As Object, _   ByVal headers() As Header _) Implements IRemotingFormatter.Serialize
[C#]
public virtual void Serialize(StreamserializationStream,objectgraph,Header[] headers);
[C++]
public: virtual void Serialize(Stream* serializationStream,Object* graph,Header* headers[]);
[JScript]
public function Serialize(
   serializationStream : Stream,graph : Object,headers : Header[]);

パラメータ

  • serializationStream
    オブジェクトをシリアル化する先のストリーム。
  • graph
    シリアル化するグラフのルートにあるオブジェクト。
  • headers
    シリアル化されたデータに含めるリモート処理ヘッダー。 null 参照 (Visual Basic では Nothing) でもかまいません。

実装

IRemotingFormatter.Serialize

例外

例外の種類 条件
ArgumentNullException serializationStream が null 参照 (Visual Basic では Nothing) です。
SerializationException シリアル化中に、 graph パラメータのオブジェクトがシリアル化可能としてマークされていないなどのエラーが発生しました。
SecurityException 呼び出し元に、必要なアクセス許可がありません。

解説

シリアル化処理では、シリアル化ストリームの先頭に、 headers パラメータに指定した情報が追加されます。

メモ   ヘッダーは、特定のリモート処理アプリケーションでだけ使用されます。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

参照

BinaryFormatter クラス | BinaryFormatter メンバ | System.Runtime.Serialization.Formatters.Binary 名前空間 | BinaryFormatter.Serialize オーバーロードの一覧