AppDomain.CreateInstance Metode

Referensi

Definisi

Ruang nama:: System

Rakitan:: System.Runtime.dll

Rakitan:: System.Runtime.Extensions.dll

Rakitan:: mscorlib.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Membuat instans baru dari jenis tertentu yang ditentukan dalam rakitan tertentu.

Overload

CreateInstance(String, String)	Membuat instans baru dari jenis yang ditentukan dalam rakitan yang ditentukan.
CreateInstance(String, String, Object[])	Membuat instans baru dari jenis yang ditentukan dalam rakitan yang ditentukan. Parameter menentukan array atribut aktivasi.
CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Membuat instans baru dari jenis yang ditentukan dalam rakitan yang ditentukan. Parameter menentukan pengikat, bendera pengikatan, argumen konstruktor, informasi khusus budaya yang digunakan untuk menginterpretasikan argumen, dan atribut aktivasi opsional.
CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)	Kedaluwarsa. Membuat instans baru dari jenis yang ditentukan dalam rakitan yang ditentukan. Parameter menentukan pengikat, bendera pengikatan, argumen konstruktor, informasi khusus budaya yang digunakan untuk menginterpretasikan argumen, atribut aktivasi, dan otorisasi untuk membuat jenis.

CreateInstance(String, String)

Sumber:: AppDomain.cs

Sumber:: AppDomain.cs

Sumber:: AppDomain.cs

Membuat instans baru dari jenis yang ditentukan dalam rakitan yang ditentukan.

public:
 System::Runtime::Remoting::ObjectHandle ^ CreateInstance(System::String ^ assemblyName, System::String ^ typeName);

public:
 virtual System::Runtime::Remoting::ObjectHandle ^ CreateInstance(System::String ^ assemblyName, System::String ^ typeName);

public System.Runtime.Remoting.ObjectHandle? CreateInstance (string assemblyName, string typeName);

public System.Runtime.Remoting.ObjectHandle CreateInstance (string assemblyName, string typeName);

member this.CreateInstance : string * string -> System.Runtime.Remoting.ObjectHandle

abstract member CreateInstance : string * string -> System.Runtime.Remoting.ObjectHandle
override this.CreateInstance : string * string -> System.Runtime.Remoting.ObjectHandle

Public Function CreateInstance (assemblyName As String, typeName As String) As ObjectHandle

Parameter

assemblyName: String

Nama tampilan rakitan. Lihat FullName.

typeName: String

Nama yang sepenuhnya memenuhi syarat dari jenis yang diminta, termasuk namespace tetapi bukan assembly, seperti yang dikembalikan oleh properti FullName.

Mengembalikan

ObjectHandle

Objek yang merupakan pembungkus untuk instans baru yang ditentukan oleh typeName. Nilai yang dikembalikan perlu dibongkar untuk mengakses objek nyata.

Penerapan

CreateInstance(String, String)

Pengecualian

AppDomainUnloadedException

Operasi ini dicoba pada domain aplikasi yang tidak dimuat.

ArgumentNullException

assemblyName atau typeNamenull.

BadImageFormatException

assemblyName bukan rakitan yang valid untuk runtime yang saat ini dimuat.

FileLoadException

Rakitan atau modul dimuat dua kali dengan dua bukti yang berbeda.

FileNotFoundException

assemblyName tidak ditemukan.

MethodAccessException

Pemanggil tidak memiliki izin untuk memanggil konstruktor ini.

MissingMethodException

Tidak ditemukan konstruktor publik yang cocok.

TypeLoadException

typeName tidak ditemukan di assemblyName.

NullReferenceException

Instans ini null.

Keterangan

Metode ini memanggil konstruktor tanpa parameter untuk typeName.

Lihat AssemblyName untuk format assemblyName.

Upaya untuk memanggil CreateInstance pada domain aplikasi target yang bukan domain aplikasi saat ini akan menghasilkan beban rakitan yang berhasil di domain aplikasi target. Karena Assembly tidak MarshalByRefObject, ketika metode ini mencoba mengembalikan Assembly untuk rakitan yang dimuat ke domain aplikasi saat ini, runtime bahasa umum akan mencoba memuat perakitan ke domain aplikasi saat ini dan beban mungkin gagal. Rakitan yang dimuat ke domain aplikasi saat ini mungkin berbeda dari rakitan yang dimuat terlebih dahulu jika pengaturan jalur untuk dua domain aplikasi berbeda.

Lihat juga

CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo)

Berlaku untuk

CreateInstance(String, String, Object[])

Sumber:: AppDomain.cs

Sumber:: AppDomain.cs

Sumber:: AppDomain.cs

Membuat instans baru dari jenis yang ditentukan dalam rakitan yang ditentukan. Parameter menentukan array atribut aktivasi.

public:
 System::Runtime::Remoting::ObjectHandle ^ CreateInstance(System::String ^ assemblyName, System::String ^ typeName, cli::array <System::Object ^> ^ activationAttributes);

public:
 virtual System::Runtime::Remoting::ObjectHandle ^ CreateInstance(System::String ^ assemblyName, System::String ^ typeName, cli::array <System::Object ^> ^ activationAttributes);

public System.Runtime.Remoting.ObjectHandle? CreateInstance (string assemblyName, string typeName, object?[]? activationAttributes);

public System.Runtime.Remoting.ObjectHandle CreateInstance (string assemblyName, string typeName, object[] activationAttributes);

member this.CreateInstance : string * string * obj[] -> System.Runtime.Remoting.ObjectHandle

abstract member CreateInstance : string * string * obj[] -> System.Runtime.Remoting.ObjectHandle
override this.CreateInstance : string * string * obj[] -> System.Runtime.Remoting.ObjectHandle

Public Function CreateInstance (assemblyName As String, typeName As String, activationAttributes As Object()) As ObjectHandle

Parameter

assemblyName: String

Nama tampilan rakitan. Lihat FullName.

typeName: String

Nama yang sepenuhnya memenuhi syarat dari jenis yang diminta, termasuk namespace tetapi bukan assembly, seperti yang dikembalikan oleh properti FullName.

activationAttributes: Object[]

Array dari satu atau beberapa atribut yang dapat berpartisipasi dalam aktivasi. Biasanya, 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

Objek yang merupakan pembungkus untuk instans baru yang ditentukan oleh typeName. Nilai yang dikembalikan perlu dibongkar untuk mengakses objek nyata.

Penerapan

CreateInstance(String, String, Object[])

Pengecualian

AppDomainUnloadedException

Operasi ini dicoba pada domain aplikasi yang tidak dimuat.

ArgumentNullException

assemblyName atau typeNamenull.

BadImageFormatException

assemblyName bukan rakitan yang valid untuk runtime yang saat ini dimuat.

FileLoadException

Rakitan atau modul dimuat dua kali dengan dua bukti yang berbeda.

FileNotFoundException

assemblyName tidak ditemukan.

MethodAccessException

Pemanggil tidak memiliki izin untuk memanggil konstruktor ini.

MissingMethodException

Tidak ditemukan konstruktor publik yang cocok.

NotSupportedException

Pemanggil tidak dapat menyediakan atribut aktivasi untuk objek yang tidak mewarisi dari MarshalByRefObject.

TypeLoadException

typeName tidak ditemukan di assemblyName.

NullReferenceException

Instans ini null.

Keterangan

Metode ini memanggil konstruktor tanpa parameter untuk typeName.

Lihat AssemblyName untuk format assemblyName.

Lihat juga

CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo)

Berlaku untuk

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

Sumber:: AppDomain.cs

Sumber:: AppDomain.cs

Sumber:: AppDomain.cs

Membuat instans baru dari jenis yang ditentukan dalam rakitan yang ditentukan. Parameter menentukan pengikat, bendera pengikatan, argumen konstruktor, informasi khusus budaya yang digunakan untuk menginterpretasikan argumen, dan atribut aktivasi opsional.

public:
 System::Runtime::Remoting::ObjectHandle ^ CreateInstance(System::String ^ assemblyName, 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 System.Runtime.Remoting.ObjectHandle? CreateInstance (string assemblyName, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, object?[]? args, System.Globalization.CultureInfo? culture, object?[]? activationAttributes);

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

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

Public Function CreateInstance (assemblyName 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

assemblyName: String

Nama tampilan rakitan. Lihat FullName.

typeName: String

Nama yang sepenuhnya memenuhi syarat dari jenis yang diminta, termasuk namespace tetapi bukan assembly, seperti yang dikembalikan oleh properti FullName.

ignoreCase: Boolean

Nilai Boolean yang menentukan apakah akan melakukan pencarian peka huruf besar/kecil atau tidak.

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 memungkinkan pengikatan, koersi jenis argumen, pemanggilan anggota, dan pengambilan objek MemberInfo menggunakan pantulan. Jika binder null, pengikat default akan digunakan.

args: Object[]

Argumen yang akan diteruskan ke konstruktor. Array argumen ini harus cocok dalam jumlah, urutan, dan ketik parameter konstruktor yang akan dipanggil. Jika konstruktor tanpa parameter lebih disukai, args harus berupa array kosong atau null.

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[]

Mengembalikan

ObjectHandle

Objek yang merupakan pembungkus untuk instans baru yang ditentukan oleh typeName. Nilai yang dikembalikan perlu dibongkar untuk mengakses objek nyata.

Pengecualian

AppDomainUnloadedException

Operasi ini dicoba pada domain aplikasi yang tidak dimuat.

ArgumentNullException

assemblyName atau typeNamenull.

BadImageFormatException

assemblyName bukan rakitan yang valid untuk runtime yang saat ini dimuat.

FileLoadException

Rakitan atau modul dimuat dua kali dengan dua bukti yang berbeda.

FileNotFoundException

assemblyName tidak ditemukan.

MethodAccessException

Pemanggil tidak memiliki izin untuk memanggil konstruktor ini.

MissingMethodException

Tidak ditemukan konstruktor yang cocok.

NotSupportedException

Pemanggil tidak dapat menyediakan atribut aktivasi untuk objek yang tidak mewarisi dari MarshalByRefObject.

TypeLoadException

typeName tidak ditemukan di assemblyName.

NullReferenceException

Instans ini null.

Keterangan

Lihat AssemblyName untuk format assemblyName.

Lihat juga

CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo)

Berlaku untuk

CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)

Perhatian

Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstance which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.

public:
 virtual System::Runtime::Remoting::ObjectHandle ^ CreateInstance(System::String ^ assemblyName, 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, System::Security::Policy::Evidence ^ securityAttributes);

public System.Runtime.Remoting.ObjectHandle CreateInstance (string assemblyName, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes, System.Security.Policy.Evidence securityAttributes);

[System.Obsolete("Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstance which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public System.Runtime.Remoting.ObjectHandle CreateInstance (string assemblyName, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes, System.Security.Policy.Evidence securityAttributes);

abstract member CreateInstance : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> System.Runtime.Remoting.ObjectHandle
override this.CreateInstance : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> System.Runtime.Remoting.ObjectHandle

[<System.Obsolete("Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstance which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")>]
abstract member CreateInstance : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> System.Runtime.Remoting.ObjectHandle
override this.CreateInstance : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> System.Runtime.Remoting.ObjectHandle

Public Function CreateInstance (assemblyName As String, typeName As String, ignoreCase As Boolean, bindingAttr As BindingFlags, binder As Binder, args As Object(), culture As CultureInfo, activationAttributes As Object(), securityAttributes As Evidence) As ObjectHandle

Parameter

assemblyName: String

Nama tampilan rakitan. Lihat FullName.

typeName: String

Nama yang sepenuhnya memenuhi syarat dari jenis yang diminta, termasuk namespace tetapi bukan assembly, seperti yang dikembalikan oleh properti FullName.

ignoreCase: Boolean

Nilai Boolean yang menentukan apakah akan melakukan pencarian peka huruf besar/kecil atau tidak.

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 memungkinkan pengikatan, koersi jenis argumen, pemanggilan anggota, dan pengambilan objek MemberInfo menggunakan pantulan. Jika binder null, pengikat default akan digunakan.

args: Object[]

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[]

securityAttributes: Evidence

Informasi yang digunakan untuk mengotorisasi pembuatan typeName.

Mengembalikan

ObjectHandle

Objek yang merupakan pembungkus untuk instans baru yang ditentukan oleh typeName. Nilai yang dikembalikan perlu dibongkar untuk mengakses objek nyata.