オブジェクト、または先頭 (ルート) を指定したオブジェクト グラフを、指定したヘッダーを結び付けて、指定したストリームにシリアル化します。
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) でもかまいません。
実装
例外
| 例外の種類 | 条件 |
|---|---|
| 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 セキュリティ:
- SecurityPermission (シリアル化サービスを提供するために必要なアクセス許可) SecurityPermissionFlag.SerializationFormatter (関連する列挙体)
参照
BinaryFormatter クラス | BinaryFormatter メンバ | System.Runtime.Serialization.Formatters.Binary 名前空間 | BinaryFormatter.Serialize オーバーロードの一覧