ComponentSerializationService.SerializeAbsolute メソッド

定義

名前空間:
System.ComponentModel.Design.Serialization
アセンブリ:
System.dll
アセンブリ:
netstandard.dll

既定のプロパティ値を計算して、指定されたオブジェクトをシリアル化します。

public:
 abstract void SerializeAbsolute(System::ComponentModel::Design::Serialization::SerializationStore ^ store, System::Object ^ value);
public abstract void SerializeAbsolute(System.ComponentModel.Design.Serialization.SerializationStore store, object value);
abstract member SerializeAbsolute : System.ComponentModel.Design.Serialization.SerializationStore * obj -> unit
Public MustOverride Sub SerializeAbsolute (store As SerializationStore, value As Object)

パラメーター

store
SerializationStore

valueの状態がシリアル化されるSerializationStore。

value
Object

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

例外

ArgumentNullException

store または value が null。

InvalidOperationException

store が閉じているか、 store がサポートされている種類のシリアル化ストアではありません。 CreateStore()によって返されるストアを使用します。

注釈

Serialize メソッドを使用して実装される標準シリアル化では、コンポーネントの既定の状態とは異なる値のみをシリアル化します。 これにより、最もコンパクトなシリアル化メカニズムが提供されますが、逆シリアル化時に新しく作成されたオブジェクトが使用されることを前提としています。 既存のオブジェクトが使用されている場合、結果の逆シリアル化されたオブジェクトは、シリアル化されたオブジェクトの元の状態を複製する保証はありません。シリアル化中に既定値を含むプロパティは、逆シリアル化中に既定値にリセットされません。

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

このメソッドは、コレクション内の構成要素の順序が変更される可能性があるため、コレクションをシリアル化する場合に特に便利です。 この状況では、コレクション全体の元の状態を復元する最も安全なプロセスは、すべてのアイテムを元のプロパティ値で上書きすることです。

適用対象

こちらもご覧ください