DesignerSerializationManager.CreateInstance メソッド

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

DesignerSerializationManager.CreateInstance メソッド

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

型のインスタンスを作成します。

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

Visual Basic (宣言)

Protected Overridable Function
 CreateInstance ( _
    type As Type, _
    arguments As ICollection, _
    name As String, _
    addToContainer As Boolean _
) As Object

Visual Basic (使用法)

Dim type As Type
Dim arguments As ICollection
Dim name As String
Dim addToContainer As Boolean
Dim returnValue As Object

returnValue = Me.CreateInstance(type, arguments, name, addToContainer)

C#

protected virtual Object CreateInstance (
    Type type,
    ICollection arguments,
    string name,
    bool addToContainer
)

C++

protected:
virtual Object^ CreateInstance (
    Type^ type, 
    ICollection^ arguments, 
    String^ name, 
    bool addToContainer
)

J#

protected Object CreateInstance (
    Type type, 
    ICollection arguments, 
    String name, 
    boolean addToContainer
)

JScript

protected function CreateInstance (
    type : Type, 
    arguments : ICollection, 
    name : String, 
    addToContainer : boolean
) : Object

パラメータ

type

作成するインスタンスの型。

arguments

型のコンストラクタのパラメータ。既定のコンストラクタを呼び出す場合、このパラメータは null 参照 (Visual Basic では Nothing) でも空のコレクションでもかまいません。

name

オブジェクトに付ける名前。null 参照 (Visual Basic では Nothing) の場合、オブジェクトに名前は付けられません。ただし、オブジェクトをコンテナに追加し、そのコンテナによってオブジェクトに名前が付けられる場合を除きます。

addToContainer

オブジェクトが IComponent を実装しているときに、コンテナにオブジェクトを追加する場合は true。それ以外の場合は false。

戻り値
type で指定した型の新しいインスタンス。

例外

例外の種類	条件
SerializationException	type は、arguments に格納されたパラメータを取得するコンストラクタを持ちません。

解説

このメソッドは、シリアライザが型のインスタンスの作成を試みたときに、シリアライザによって呼び出されます。既定の実装は、型の新しいインスタンスを作成します。また、PreserveNames プロパティと RecycleInstances プロパティの値によっては、既存のインスタンスを返す場合もあります。CreateInstance メソッドは、リフレクションを使用してインスタンスを作成し、パラメータで一部の汎用的な IConvertible 変換を実行して、一致するコンストラクタを見つけます。

.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 名前空間
CreateSession
System.ComponentModel.Design.Serialization.IDesignerSerializationManager.GetInstance
RecycleInstances
ValidateRecycledTypes