AppDomain.CreateInstance Metode
Definisi
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
- typeName
- String
Nama yang sepenuhnya memenuhi syarat dari jenis yang diminta, termasuk namespace tetapi bukan assembly, seperti yang dikembalikan oleh properti FullName.
Mengembalikan
Objek yang merupakan pembungkus untuk instans baru yang ditentukan oleh typeName
. Nilai yang dikembalikan perlu dibongkar untuk mengakses objek nyata.
Penerapan
Pengecualian
Operasi ini dicoba pada domain aplikasi yang tidak dimuat.
assemblyName
atau typeName
null
.
assemblyName
bukan rakitan yang valid untuk runtime yang saat ini dimuat.
Rakitan atau modul dimuat dua kali dengan dua bukti yang berbeda.
assemblyName
tidak ditemukan.
Pemanggil tidak memiliki izin untuk memanggil konstruktor ini.
Tidak ditemukan konstruktor publik yang cocok.
typeName
tidak ditemukan di assemblyName
.
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
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
- 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
Objek yang merupakan pembungkus untuk instans baru yang ditentukan oleh typeName
. Nilai yang dikembalikan perlu dibongkar untuk mengakses objek nyata.
Penerapan
Pengecualian
Operasi ini dicoba pada domain aplikasi yang tidak dimuat.
assemblyName
atau typeName
null
.
assemblyName
bukan rakitan yang valid untuk runtime yang saat ini dimuat.
Rakitan atau modul dimuat dua kali dengan dua bukti yang berbeda.
assemblyName
tidak ditemukan.
Pemanggil tidak memiliki izin untuk memanggil konstruktor ini.
Tidak ditemukan konstruktor publik yang cocok.
Pemanggil tidak dapat menyediakan atribut aktivasi untuk objek yang tidak mewarisi dari MarshalByRefObject.
typeName
tidak ditemukan di assemblyName
.
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
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
- 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 culture
null
, CultureInfo untuk utas saat ini digunakan.
- 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
Objek yang merupakan pembungkus untuk instans baru yang ditentukan oleh typeName
. Nilai yang dikembalikan perlu dibongkar untuk mengakses objek nyata.
Pengecualian
Operasi ini dicoba pada domain aplikasi yang tidak dimuat.
assemblyName
atau typeName
null
.
assemblyName
bukan rakitan yang valid untuk runtime yang saat ini dimuat.
Rakitan atau modul dimuat dua kali dengan dua bukti yang berbeda.
assemblyName
tidak ditemukan.
Pemanggil tidak memiliki izin untuk memanggil konstruktor ini.
Tidak ditemukan konstruktor yang cocok.
Pemanggil tidak dapat menyediakan atribut aktivasi untuk objek yang tidak mewarisi dari MarshalByRefObject.
typeName
tidak ditemukan di assemblyName
.
Instans ini null
.
Keterangan
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
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.
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.
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
- 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 culture
null
, CultureInfo untuk utas saat ini digunakan.
- 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.
- securityAttributes
- Evidence
Informasi yang digunakan untuk mengotorisasi pembuatan typeName
.
Mengembalikan
Objek yang merupakan pembungkus untuk instans baru yang ditentukan oleh typeName
. Nilai yang dikembalikan perlu dibongkar untuk mengakses objek nyata.
Penerapan
- Atribut
Pengecualian
Operasi ini dicoba pada domain aplikasi yang tidak dimuat.
assemblyName
atau typeName
null
.
assemblyName
bukan rakitan yang valid untuk runtime yang saat ini dimuat.
Rakitan atau modul dimuat dua kali dengan dua bukti yang berbeda.
assemblyName
tidak ditemukan.
Pemanggil tidak memiliki izin untuk memanggil konstruktor ini.
Tidak ditemukan konstruktor yang cocok.
Pemanggil tidak dapat menyediakan atribut aktivasi untuk objek yang tidak mewarisi dari MarshalByRefObject.
-atau-
securityAttributes
tidak null
. Ketika kebijakan CAS warisan tidak diaktifkan, securityAttributes
harus null
typeName
tidak ditemukan di assemblyName
.
Instans ini null
.
Keterangan
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
Berlaku untuk
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk