Activator.CreateInstanceFrom Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Membuat instans jenis yang namanya ditentukan, menggunakan file rakitan bernama dan konstruktor yang paling cocok dengan parameter yang ditentukan.

Overload

CreateInstanceFrom(String, String, Object[])	Membuat instans jenis yang namanya ditentukan, menggunakan file rakitan bernama dan konstruktor tanpa parameter.
CreateInstanceFrom(String, String)	Membuat instans jenis yang namanya ditentukan, menggunakan file rakitan bernama dan konstruktor tanpa parameter.
CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Membuat instans jenis yang namanya ditentukan, menggunakan file rakitan bernama dan konstruktor yang paling cocok dengan parameter yang ditentukan.

CreateInstanceFrom(String, String, Object[])

Sumber:

Activator.cs

Membuat instans jenis yang namanya ditentukan, menggunakan file rakitan bernama dan konstruktor tanpa parameter.

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(System::String ^ assemblyFile, System::String ^ typeName, cli::array <System::Object ^> ^ activationAttributes);

public static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom (string assemblyFile, string typeName, object?[]? activationAttributes);

static member CreateInstanceFrom : string * string * obj[] -> System.Runtime.Remoting.ObjectHandle

Public Shared Function CreateInstanceFrom (assemblyFile As String, typeName As String, activationAttributes As Object()) As ObjectHandle

Parameter

assemblyFile

String

Nama file yang berisi rakitan tempat tipe bernama typeName dicari.

typeName

String

Nama jenis untuk membuat instans.

activationAttributes

Object[]

Array dari satu atau beberapa atribut yang dapat berpartisipasi dalam aktivasi. Ini biasanya merupakan array yang berisi satu objek UrlAttribute yang menentukan URL yang diperlukan untuk mengaktifkan objek jarak jauh.

Parameter ini terkait dengan objek yang diaktifkan klien. Aktivasi klien adalah teknologi warisan yang dipertahankan untuk kompatibilitas mundur tetapi tidak direkomendasikan untuk pengembangan baru. Aplikasi terdistribusi harus menggunakan Windows Communication Foundation.

Mengembalikan

ObjectHandle

Handel yang harus dibongkar untuk mengakses objek yang baru dibuat, atau null untuk instans Nullable<T>.

Pengecualian

ArgumentNullException

typeName null.

MissingMethodException

Tidak ditemukan konstruktor publik yang cocok.

TypeLoadException

typeName tidak ditemukan di assemblyFile.

FileNotFoundException

assemblyFile tidak ditemukan.

MethodAccessException

Pemanggil tidak memiliki izin untuk memanggil konstruktor ini.

MemberAccessException

Tidak dapat membuat instans kelas abstrak, atau anggota ini dipanggil dengan mekanisme pengikatan terlambat.

TargetInvocationException

Konstruktor, yang dipanggil melalui pantulan, melemparkan pengecualian.

NotSupportedException

activationAttributes bukan array kosong, dan jenis yang dibuat tidak berasal dari MarshalByRefObject.

SecurityException

Pemanggil memang memiliki FileIOPermissionyang diperlukan.

BadImageFormatException

assemblyFile bukan rakitan yang valid.

-atau-

Runtime bahasa umum (CLR) versi 2.0 atau yang lebih baru saat ini dimuat, dan assemblyFile dikompilasi untuk versi CLR yang lebih baru dari versi yang saat ini dimuat. Perhatikan bahwa .NET Framework versi 2.0, 3.0, dan 3.5 semuanya menggunakan CLR versi 2.0.

Keterangan

Gunakan metode ObjectHandle.Unwrap untuk membuka bungkus nilai yang dikembalikan.

Untuk informasi tentang pengecualian lain yang dapat dilemparkan dengan metode yang dipanggil, lihat bagian Pengecualian dari metode Assembly.LoadFrom dan CreateInstance.

CreateInstanceFrom(String, String)

Sumber:

Activator.cs

Membuat instans jenis yang namanya ditentukan, menggunakan file rakitan bernama dan konstruktor tanpa parameter.

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(System::String ^ assemblyFile, System::String ^ typeName);

public static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom (string assemblyFile, string typeName);

static member CreateInstanceFrom : string * string -> System.Runtime.Remoting.ObjectHandle

Public Shared Function CreateInstanceFrom (assemblyFile As String, typeName As String) As ObjectHandle

Parameter

assemblyFile

String

Nama file yang berisi rakitan tempat tipe bernama typeName dicari.

typeName

String

Nama jenis untuk membuat instans.

Mengembalikan

ObjectHandle

Handel yang harus dibongkar untuk mengakses objek yang baru dibuat, atau null untuk instans Nullable<T>.

Pengecualian

ArgumentNullException

typeName null.

MissingMethodException

Tidak ditemukan konstruktor publik yang cocok.

TypeLoadException

typeName tidak ditemukan di assemblyFile.

FileNotFoundException

assemblyFile tidak ditemukan.

MethodAccessException

Pemanggil tidak memiliki izin untuk memanggil konstruktor ini.

MemberAccessException

Tidak dapat membuat instans kelas abstrak, atau anggota ini dipanggil dengan mekanisme pengikatan terlambat.

TargetInvocationException

Konstruktor, yang dipanggil melalui pantulan, melemparkan pengecualian.

SecurityException

Pemanggil memang memiliki FileIOPermissionyang diperlukan.

BadImageFormatException

assemblyFile bukan rakitan yang valid.

-atau-

Runtime bahasa umum (CLR) versi 2.0 atau yang lebih baru saat ini dimuat, dan assemblyFile dikompilasi untuk versi CLR yang lebih baru dari versi yang saat ini dimuat. Perhatikan bahwa .NET Framework versi 2.0, 3.0, dan 3.5 semuanya menggunakan CLR versi 2.0.

Contoh

Contoh kode berikut menunjukkan cara memanggil metode CreateInstanceFrom. Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk kelas Activator.

// Create an instance of the SomeType class that is defined in this 
// assembly.
System::Runtime::Remoting::ObjectHandle^ oh = 
    Activator::CreateInstanceFrom(Assembly::GetEntryAssembly()->CodeBase, 
                                  SomeType::typeid->FullName);

// Call an instance method defined by the SomeType type using this object.
SomeType^ st = (SomeType^) oh->Unwrap();

st->DoSomething(5);

// Create an instance of the SomeType class that is defined in this
// assembly.
System.Runtime.Remoting.ObjectHandle oh =
    Activator.CreateInstanceFrom(Assembly.GetEntryAssembly().CodeBase,
                                 typeof(SomeType).FullName);

// Call an instance method defined by the SomeType type using this object.
SomeType st = (SomeType) oh.Unwrap();

st.DoSomething(5);

// Create an instance of the SomeType class that is defined in this assembly.
let oh = 
    Activator.CreateInstanceFrom(Assembly.GetEntryAssembly().Location, typeof<SomeType>.FullName)

// Call an instance method defined by the SomeType type using this object.
let st = oh.Unwrap() :?> SomeType

st.DoSomething 5

' Create an instance of the SomeType class that is defined in this assembly.
Dim oh As System.Runtime.Remoting.ObjectHandle = _
    Activator.CreateInstanceFrom(Assembly.GetEntryAssembly().CodeBase, _
                                 GetType(SomeType).FullName)

' Call an instance method defined by the SomeType type using this object.
Dim st As SomeType = CType(oh.Unwrap(), SomeType)

st.DoSomething(5)

Keterangan

Gunakan metode ObjectHandle.Unwrap untuk membuka bungkus nilai yang dikembalikan.

Untuk informasi tentang pengecualian lain yang dapat dilemparkan dengan metode yang dipanggil, lihat bagian Pengecualian dari metode Assembly.LoadFrom dan CreateInstance.

CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])

Sumber:

Activator.cs

Membuat instans jenis yang namanya ditentukan, menggunakan file rakitan bernama dan konstruktor yang paling cocok dengan parameter yang ditentukan.

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(System::String ^ assemblyFile, System::String ^ typeName, bool ignoreCase, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, cli::array <System::Object ^> ^ args, System::Globalization::CultureInfo ^ culture, cli::array <System::Object ^> ^ activationAttributes);

public static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom (string assemblyFile, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, object?[]? args, System.Globalization.CultureInfo? culture, object?[]? activationAttributes);

static member CreateInstanceFrom : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> System.Runtime.Remoting.ObjectHandle

Public Shared Function CreateInstanceFrom (assemblyFile As String, typeName As String, ignoreCase As Boolean, bindingAttr As BindingFlags, binder As Binder, args As Object(), culture As CultureInfo, activationAttributes As Object()) As ObjectHandle

Parameter

assemblyFile

String

Nama file yang berisi rakitan tempat tipe bernama typeName dicari.

typeName

String

Nama jenis untuk membuat instans.

ignoreCase

Boolean

true untuk menentukan bahwa pencarian typeName tidak peka huruf besar/kecil; false untuk menentukan bahwa pencarian peka huruf besar/kecil.

bindingAttr

BindingFlags

Kombinasi bendera nol atau lebih bit yang memengaruhi pencarian konstruktor typeName. Jika bindingAttr nol, pencarian peka huruf besar/kecil untuk konstruktor publik dilakukan.

binder

Binder

Objek yang menggunakan bindingAttr dan args untuk mencari dan mengidentifikasi konstruktor typeName. Jika bindernull, pengikat default digunakan.

args

Object[]

Array argumen yang cocok dengan angka, urutan, dan ketik parameter konstruktor yang akan dipanggil. Jika args adalah array kosong atau null, konstruktor yang tidak mengambil parameter (konstruktor tanpa parameter) dipanggil.

culture

CultureInfo

Informasi khusus budaya yang mengatur pemasukan args ke jenis formal yang dideklarasikan untuk konstruktor typeName. Jika culturenull, CultureInfo untuk utas saat ini digunakan.

activationAttributes

Object[]

Array dari satu atau beberapa atribut yang dapat berpartisipasi dalam aktivasi. Ini biasanya merupakan array yang berisi satu objek UrlAttribute yang menentukan URL yang diperlukan untuk mengaktifkan objek jarak jauh.

Parameter ini terkait dengan objek yang diaktifkan klien. Aktivasi klien adalah teknologi warisan yang dipertahankan untuk kompatibilitas mundur tetapi tidak direkomendasikan untuk pengembangan baru. Aplikasi terdistribusi harus menggunakan Windows Communication Foundation.

Mengembalikan

ObjectHandle

Handel yang harus dibongkar untuk mengakses objek yang baru dibuat, atau null untuk instans Nullable<T>.

Pengecualian

ArgumentNullException

typeName null.

MissingMethodException

Tidak ditemukan konstruktor yang cocok.

TypeLoadException

typeName tidak ditemukan di assemblyFile.

FileNotFoundException

assemblyFile tidak ditemukan.

MethodAccessException

Pemanggil tidak memiliki izin untuk memanggil konstruktor ini.

MemberAccessException

Tidak dapat membuat instans kelas abstrak, atau anggota ini dipanggil dengan mekanisme pengikatan terlambat.

TargetInvocationException

Konstruktor, yang dipanggil melalui pantulan, melemparkan pengecualian.

SecurityException

Pemanggil tidak memiliki FileIOPermissionyang diperlukan.

NotSupportedException

activationAttributes bukan array kosong, dan jenis yang dibuat tidak berasal dari MarshalByRefObject.

BadImageFormatException

assemblyFile bukan rakitan yang valid.

-atau-

Runtime bahasa umum (CLR) versi 2.0 atau yang lebih baru saat ini dimuat, dan assemblyFile dikompilasi untuk versi CLR yang lebih baru dari versi yang saat ini dimuat. Perhatikan bahwa .NET Framework versi 2.0, 3.0, dan 3.5 semuanya menggunakan CLR versi 2.0.

Keterangan

Gunakan metode ObjectHandle.Unwrap untuk membuka bungkus nilai yang dikembalikan.

Untuk informasi tentang pengecualian lain yang dapat dilemparkan dengan metode yang dipanggil, lihat bagian Pengecualian dari metode Assembly.LoadFrom dan CreateInstance.