DesignerSerializationManager.PreserveNames プロパティ

定義

名前空間:

System.ComponentModel.Design.Serialization

アセンブリ:

System.Windows.Forms.Design.dll

CreateInstance(Type, ICollection, String, Boolean) メソッドが、コンテナーに指定した名前が存在することをチェックする必要があるかどうかを示す値を取得または設定します。

public:
 property bool PreserveNames { bool get(); void set(bool value); };

public bool PreserveNames { get; set; }

member this.PreserveNames : bool with get, set

Public Property PreserveNames As Boolean

プロパティ値

Boolean

CreateInstance(Type, ICollection, String, Boolean) が指定したコンポーネント名を渡す場合は true。CreateInstance(Type, ICollection, String, Boolean) がコンテナーに指定した名前が存在するかどうかチェックする場合は false。 既定値は、true です。

例外

InvalidOperationException

このプロパティは、シリアル化セッション内から変更されました。

注釈

プロパティは PreserveNames 、 メソッドの動作を CreateInstance 決定します。 のCreateInstance場合trueは、指定されたコンポーネント名が渡されます。 のCreateInstance場合false、コンテナー内に指定された名前が存在するかどうかがチェックされます。 名前がコンテナーに存在しない場合は、 CreateInstance 指定された名前が使用されます。 名前がコンテナーに存在する場合、 CreateInstance コンテナーに追加するときにコンポーネントの名前として null 値が渡され、新しい名前が付けられます。 この 2 番目のバリエーションは、オブジェクトが存在しないと想定するのではなく、常にオブジェクトを複製するシリアライザーを実装する場合に便利です。 貼り付けコマンドでは、多くの場合、この種類のシリアライザーが使用されます。

このプロパティは、シリアル化セッションに参加していない場合にのみ変更できます。

こちらもご覧ください

• DesignerSerializationManager
• CreateInstance(Type, ICollection, String, Boolean)