IDesignerSerializationManager.SerializationComplete イベント

.NET Framework クラス ライブラリ リファレンス

IDesignerSerializationManager.SerializationComplete イベント

シリアル化が完了したときに発生します。

名前空間: System.ComponentModel.Design.Serialization
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Event SerializationComplete As EventHandler

Visual Basic (使用法)

Dim instance As IDesignerSerializationManager
Dim handler As EventHandler

AddHandler instance.SerializationComplete, handler

C#

event EventHandler SerializationComplete

C++

event EventHandler^ SerializationComplete {
    void add (EventHandler^ value);
    void remove (EventHandler^ value);
}

J#

/** @event */
void add_SerializationComplete (EventHandler value)

/** @event */
void remove_SerializationComplete (EventHandler value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

このイベントは、シリアル化または逆シリアル化が完了したときに発生します。

一般に、シリアル化コードはシリアル化データの生成だけを行い、状態に関連するチェックや処理は要求しません。シリアル化中に状態データを保持する必要がある場合は、SerializationComplete イベントを待機できるシリアライザがデータの設定とアクセスを行い、シリアル化後にデータを消去できます。シリアライザはシリアル化中に再利用できますが、残された状態データまたは開いたストリームが正しくない可能性があるため、シリアル化後に適切な状態を復元することが重要です。

たとえば、シリアライザがリソース ファイルなどの別のファイルに書き込む必要がある場合、終了時にそのファイルを閉じるようにシリアライザをデザインすることは効率がよくありません。通常、オブジェクト グラフのシリアル化は、複数のシリアライザを要求します。それだけでは、リソース ファイルが何度も開いたり閉じたりしてしまいます。代わりに、SerializationComplete イベントを待機するオブジェクトによって、シリアル化の終了時にリソース ファイルを閉じることができます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
IDesignerSerializationManager インターフェイス
IDesignerSerializationManager メンバ
System.ComponentModel.Design.Serialization 名前空間