DesignerSerializationManager.PreserveNames プロパティ

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

DesignerSerializationManager.PreserveNames プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

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

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

Visual Basic (宣言)

Public Property PreserveNames As
 Boolean

Visual Basic (使用法)

Dim instance As DesignerSerializationManager
Dim value As Boolean

value = instance.PreserveNames

instance.PreserveNames = value

C#

public bool PreserveNames { get;
 set; }

C++

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

J#

/** @property */
public boolean get_PreserveNames ()

/** @property */
public void set_PreserveNames (boolean value)

JScript

public function get PreserveNames
 () : boolean

public function set PreserveNames
 (value : boolean)

プロパティ値
CreateInstance が指定したコンポーネント名を渡す場合は true。CreateInstance がコンテナに指定した名前が存在するかどうかチェックする場合は false。既定値は true です。

例外

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

解説

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

このプロパティを変更できるのは、シリアル化セッション内ではない場合だけです。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

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

参照

関連項目
DesignerSerializationManager クラス
DesignerSerializationManager メンバ
System.ComponentModel.Design.Serialization 名前空間
DesignerSerializationManager
CreateInstance