ComponentSerializationService.SerializeAbsolute メソッド

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

ComponentSerializationService.SerializeAbsolute メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

既定のプロパティ値を構成する、指定したオブジェクトをシリアル化します。

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

Visual Basic (宣言)

Public MustOverride Sub
 SerializeAbsolute ( _
    store As SerializationStore, _
    value As Object _
)

Visual Basic (使用法)

Dim instance As ComponentSerializationService
Dim store As SerializationStore
Dim value As Object

instance.SerializeAbsolute(store, value)

C#

public abstract void SerializeAbsolute (
    SerializationStore store,
    Object value
)

C++

public:
virtual void SerializeAbsolute (
    SerializationStore^ store, 
    Object^ value
) abstract

J#

public abstract void SerializeAbsolute (
    SerializationStore store, 
    Object value
)

JScript

public abstract function SerializeAbsolute
 (
    store : SerializationStore, 
    value : Object
)

パラメータ

store

value の状態のシリアル化先となる SerializationStore。

value

シリアル化するオブジェクト。

例外

例外の種類	条件
ArgumentNullException	store または value が null 参照 (Visual Basic では Nothing) です。
InvalidOperationException	store が閉じているか、store がシリアル化ストアのサポートされた型ではありません。CreateStore によって返されたストアを使用してください。

解説

Serialize メソッドを使用して実装された通常のシリアル化では、コンポーネントの既定の状態と異なる値だけをシリアル化します。これは、最もコンパクトなシリアル化機構を提供します。ただし、逆シリアル化の実行時に、新しく作成したオブジェクトを使用することを前提としています。既存のオブジェクトを使用する場合、逆シリアル化によって生成されたオブジェクトが、シリアル化されたオブジェクトの元の状態を複製しているという保証はありません。シリアル化の実行時に既定値を格納しているプロパティは、逆シリアル化の実行時にその既定値にリセットされるわけではありません。

SerializeAbsolute メソッドは、このショートカットを使用しません。既定の状態に関係なく、逆シリアル化でオブジェクトのすべてのプロパティを復元できるように、このメソッドはソース オブジェクトのすべてのプロパティをシリアル化します。

コレクション内の構成項目の順序は変更できるため、このメソッドはコレクションをシリアル化する場合に特に役立ちます。この場合、コレクション全体の元の状態を復元する最も安全なプロセスは、元のすべてのプロパティ値ですべての項目を上書きすることです。

プラットフォーム

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

参照

関連項目
ComponentSerializationService クラス
ComponentSerializationService メンバ
System.ComponentModel.Design.Serialization 名前空間
SerializationStore
MemberDescriptor クラス
Serialize
SerializeMember
SerializeMemberAbsolute