AppDomain.CreateInstance Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Létrehoz egy adott szerelvényben definiált, megadott típusú új példányt.
Túlterhelések
| Name | Description |
|---|---|
| CreateInstance(String, String) |
Létrehoz egy új példányt a megadott szerelvényben definiált megadott típusból. |
| CreateInstance(String, String, Object[]) |
Létrehoz egy új példányt a megadott szerelvényben definiált megadott típusból. A paraméter az aktiválási attribútumok tömbét adja meg. |
| CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[]) |
Létrehoz egy új példányt a megadott szerelvényben definiált megadott típusból. A paraméterek kötőanyagot, kötésjelzőket, konstruktorargumentumokat, az argumentumok értelmezéséhez használt kultúraspecifikus információkat és opcionális aktiválási attribútumokat határoznak meg. |
| CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence) |
Elavult.
Létrehoz egy új példányt a megadott szerelvényben definiált megadott típusból. A paraméterek kötőanyagot, kötésjelzőket, konstruktorargumentumokat, az argumentumok értelmezéséhez használt kultúraspecifikus információkat, aktiválási attribútumokat és a típus létrehozásának engedélyezését határozzák meg. |
CreateInstance(String, String)
Létrehoz egy új példányt a megadott szerelvényben definiált megadott típusból.
public:
virtual System::Runtime::Remoting::ObjectHandle ^ CreateInstance(System::String ^ assemblyName, System::String ^ typeName);public System.Runtime.Remoting.ObjectHandle CreateInstance(string assemblyName, string typeName);abstract member CreateInstance : string * string -> System.Runtime.Remoting.ObjectHandle
override this.CreateInstance : string * string -> System.Runtime.Remoting.ObjectHandlePublic Function CreateInstance (assemblyName As String, typeName As String) As ObjectHandleParaméterek
- typeName
- String
A kért típus teljes neve, beleértve a névteret, de a szerelvényt nem, a FullName tulajdonság által visszaadott módon.
Válaszok
Egy objektum, amely burkoló a megadott typeNameúj példányhoz. A visszatérési értéket le kell bontani a valódi objektum eléréséhez.
Megvalósítás
Kivételek
A művelet egy kiürített alkalmazástartományon van megkísérlve.
assemblyName vagy typeName az null.
assemblyName nem érvényes szerelvény az aktuálisan betöltött futtatókörnyezethez.
Egy szerelvényt vagy modult kétszer töltöttek be két különböző bizonyítékkal.
assemblyName nem található.
A hívónak nincs engedélye a konstruktor meghívására.
Nem található egyező nyilvános konstruktor.
typeName nem található a következőben assemblyName: .
Ez a példány .null
Megjegyzések
Ez a metódus meghívja a paraméter nélküli konstruktort a következőhöz typeName: .
Lásd AssemblyName a formátumot assemblyName.
Ha olyan célalkalmazás-tartományt próbál meghívni CreateInstance , amely nem az aktuális alkalmazástartomány, a szerelvény sikeres betöltését eredményezi a célalkalmazás-tartományban. Assembly Mivel ez a metódus nem MarshalByRefObject, amikor ez a metódus megpróbálja visszaadni a Assembly betöltött szerelvényt az aktuális alkalmazástartományba, a közös nyelvi futtatókörnyezet megpróbálja betölteni a szerelvényt az aktuális alkalmazástartományba, és a terhelés sikertelen lehet. Az aktuális alkalmazástartományba betöltött szerelvény eltérhet az elsőként betöltött szerelvénytől, ha a két alkalmazástartomány elérési útja eltérő.
Lásd még
A következőre érvényes:
CreateInstance(String, String, Object[])
Létrehoz egy új példányt a megadott szerelvényben definiált megadott típusból. A paraméter az aktiválási attribútumok tömbét adja meg.
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);abstract member CreateInstance : string * string * obj[] -> System.Runtime.Remoting.ObjectHandle
override this.CreateInstance : string * string * obj[] -> System.Runtime.Remoting.ObjectHandlePublic Function CreateInstance (assemblyName As String, typeName As String, activationAttributes As Object()) As ObjectHandleParaméterek
- typeName
- String
A kért típus teljes neve, beleértve a névteret, de a szerelvényt nem, a FullName tulajdonság által visszaadott módon.
- activationAttributes
- Object[]
Egy vagy több attribútum tömbje, amely részt vehet az aktiválásban. Általában egy olyan tömb, amely egyetlen UrlAttribute objektumot tartalmaz, amely megadja a távoli objektum aktiválásához szükséges URL-címet.
Ez a paraméter ügyfél által aktivált objektumokhoz kapcsolódik. Az ügyfélaktiválás egy régi technológia, amely megmarad a visszamenőleges kompatibilitás érdekében, de nem ajánlott az új fejlesztéshez. Az elosztott alkalmazásoknak ehelyett Windows kommunikációs alaprendszer kell használniuk.
Válaszok
Egy objektum, amely burkoló a megadott typeNameúj példányhoz. A visszatérési értéket le kell bontani a valódi objektum eléréséhez.
Megvalósítás
Kivételek
A művelet egy kiürített alkalmazástartományon van megkísérlve.
assemblyName vagy typeName az null.
assemblyName nem érvényes szerelvény az aktuálisan betöltött futtatókörnyezethez.
Egy szerelvényt vagy modult kétszer töltöttek be két különböző bizonyítékkal.
assemblyName nem található.
A hívónak nincs engedélye a konstruktor meghívására.
Nem található egyező nyilvános konstruktor.
A hívó nem tud aktiválási attribútumokat megadni egy olyan objektumhoz, amely nem öröklődik.MarshalByRefObject
typeName nem található a következőben assemblyName: .
Ez a példány .null
Megjegyzések
Ez a metódus meghívja a paraméter nélküli konstruktort a következőhöz typeName: .
Lásd AssemblyName a formátumot assemblyName.
Ha olyan célalkalmazás-tartományt próbál meghívni CreateInstance , amely nem az aktuális alkalmazástartomány, a szerelvény sikeres betöltését eredményezi a célalkalmazás-tartományban. Assembly Mivel ez a metódus nem MarshalByRefObject, amikor ez a metódus megpróbálja visszaadni a Assembly betöltött szerelvényt az aktuális alkalmazástartományba, a közös nyelvi futtatókörnyezet megpróbálja betölteni a szerelvényt az aktuális alkalmazástartományba, és a terhelés sikertelen lehet. Az aktuális alkalmazástartományba betöltött szerelvény eltérhet az elsőként betöltött szerelvénytől, ha a két alkalmazástartomány elérési útja eltérő.
Lásd még
A következőre érvényes:
CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])
Létrehoz egy új példányt a megadott szerelvényben definiált megadott típusból. A paraméterek kötőanyagot, kötésjelzőket, konstruktorargumentumokat, az argumentumok értelmezéséhez használt kultúraspecifikus információkat és opcionális aktiválási attribútumokat határoznak meg.
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);member this.CreateInstance : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> System.Runtime.Remoting.ObjectHandlePublic 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 ObjectHandleParaméterek
- typeName
- String
A kért típus teljes neve, beleértve a névteret, de a szerelvényt nem, a FullName tulajdonság által visszaadott módon.
- ignoreCase
- Boolean
Logikai érték, amely meghatározza, hogy kis- és nagybetűkre érzékeny keresést hajt-e végre.
- bindingAttr
- BindingFlags
Nulla vagy több bitjelző kombinációja, amelyek befolyásolják a konstruktor keresését typeName . Ha bindingAttr nulla, akkor a rendszer megkülönbözteti a nyilvános konstruktorok kis- és nagybetűket.
- binder
- Binder
Olyan objektum, amely lehetővé teszi az argumentumtípusok kötését, kényszerítését, a tagok meghívását és az objektumok visszatükrözéssel történő lekérését MemberInfo . Null érték esetén binder a rendszer az alapértelmezett kötőanyagot használja.
- args
- Object[]
A konstruktornak átadni kívánt argumentumok. Ennek az argumentumtömbnek számban, sorrendben kell egyeznie, és be kell gépelnie a meghívandó konstruktor paramétereit. Ha előnyben részesíti a paraméter nélküli konstruktort, args üres tömbnek vagy nullnak kell lennie.
- culture
- CultureInfo
Kultúraspecifikus információk, amelyek a konstruktor számára typeName deklarált formális típusok kényszerítésére args vonatkoznak. Ha culture igen null, akkor a rendszer az CultureInfo aktuális szálat használja.
- activationAttributes
- Object[]
Egy vagy több attribútum tömbje, amely részt vehet az aktiválásban. Általában egy olyan tömb, amely egyetlen UrlAttribute objektumot tartalmaz, amely megadja a távoli objektum aktiválásához szükséges URL-címet.
Ez a paraméter ügyfél által aktivált objektumokhoz kapcsolódik. Az ügyfélaktiválás egy régi technológia, amely megmarad a visszamenőleges kompatibilitás érdekében, de nem ajánlott az új fejlesztéshez. Az elosztott alkalmazásoknak ehelyett Windows kommunikációs alaprendszer kell használniuk.
Válaszok
Egy objektum, amely burkoló a megadott typeNameúj példányhoz. A visszatérési értéket le kell bontani a valódi objektum eléréséhez.
Kivételek
A művelet egy kiürített alkalmazástartományon van megkísérlve.
assemblyName vagy typeName az null.
assemblyName nem érvényes szerelvény az aktuálisan betöltött futtatókörnyezethez.
Egy szerelvényt vagy modult kétszer töltöttek be két különböző bizonyítékkal.
assemblyName nem található.
A hívónak nincs engedélye a konstruktor meghívására.
Nem található egyező konstruktor.
A hívó nem tud aktiválási attribútumokat megadni egy olyan objektumhoz, amely nem öröklődik.MarshalByRefObject
typeName nem található a következőben assemblyName: .
Ez a példány .null
Megjegyzések
Lásd AssemblyName a formátumot assemblyName.
Ha olyan célalkalmazás-tartományt próbál meghívni CreateInstance , amely nem az aktuális alkalmazástartomány, a szerelvény sikeres betöltését eredményezi a célalkalmazás-tartományban. Assembly Mivel ez a metódus nem MarshalByRefObject, amikor ez a metódus megpróbálja visszaadni a Assembly betöltött szerelvényt az aktuális alkalmazástartományba, a közös nyelvi futtatókörnyezet megpróbálja betölteni a szerelvényt az aktuális alkalmazástartományba, és a terhelés sikertelen lehet. Az aktuális alkalmazástartományba betöltött szerelvény eltérhet az elsőként betöltött szerelvénytől, ha a két alkalmazástartomány elérési útja eltérő.
Lásd még
A következőre érvényes:
CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)
Figyelemfelhívás
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.
Létrehoz egy új példányt a megadott szerelvényben definiált megadott típusból. A paraméterek kötőanyagot, kötésjelzőket, konstruktorargumentumokat, az argumentumok értelmezéséhez használt kultúraspecifikus információkat, aktiválási attribútumokat és a típus létrehozásának engedélyezését határozzák meg.
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.ObjectHandlePublic 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 ObjectHandleParaméterek
- typeName
- String
A kért típus teljes neve, beleértve a névteret, de a szerelvényt nem, a FullName tulajdonság által visszaadott módon.
- ignoreCase
- Boolean
Logikai érték, amely meghatározza, hogy kis- és nagybetűkre érzékeny keresést hajt-e végre.
- bindingAttr
- BindingFlags
Nulla vagy több bitjelző kombinációja, amelyek befolyásolják a konstruktor keresését typeName . Ha bindingAttr nulla, akkor a rendszer megkülönbözteti a nyilvános konstruktorok kis- és nagybetűket.
- binder
- Binder
Olyan objektum, amely lehetővé teszi az argumentumtípusok kötését, kényszerítését, a tagok meghívását és az objektumok visszatükrözéssel történő lekérését MemberInfo . Null érték esetén binder a rendszer az alapértelmezett kötőanyagot használja.
- args
- Object[]
A konstruktornak átadni kívánt argumentumok. Ennek az argumentumtömbnek számban, sorrendben kell egyeznie, és be kell gépelnie a meghívandó konstruktor paramétereit. Ha előnyben részesíti a paraméter nélküli konstruktort, args üres tömbnek vagy nullnak kell lennie.
- culture
- CultureInfo
Kultúraspecifikus információk, amelyek a konstruktor számára typeName deklarált formális típusok kényszerítésére args vonatkoznak. Ha culture igen null, akkor a rendszer az CultureInfo aktuális szálat használja.
- activationAttributes
- Object[]
Egy vagy több attribútum tömbje, amely részt vehet az aktiválásban. Általában egy olyan tömb, amely egyetlen UrlAttribute objektumot tartalmaz, amely megadja a távoli objektum aktiválásához szükséges URL-címet.
Ez a paraméter ügyfél által aktivált objektumokhoz kapcsolódik. Az ügyfélaktiválás egy régi technológia, amely megmarad a visszamenőleges kompatibilitás érdekében, de nem ajánlott az új fejlesztéshez. Az elosztott alkalmazásoknak ehelyett Windows kommunikációs alaprendszer kell használniuk.
- securityAttributes
- Evidence
A létrehozás typeNameengedélyezéséhez használt információk.
Válaszok
Egy objektum, amely burkoló a megadott typeNameúj példányhoz. A visszatérési értéket le kell bontani a valódi objektum eléréséhez.
Megvalósítás
- Attribútumok
Kivételek
A művelet egy kiürített alkalmazástartományon van megkísérlve.
assemblyName vagy typeName az null.
assemblyName nem érvényes szerelvény az aktuálisan betöltött futtatókörnyezethez.
Egy szerelvényt vagy modult kétszer töltöttek be két különböző bizonyítékkal.
assemblyName nem található.
A hívónak nincs engedélye a konstruktor meghívására.
Nem található egyező konstruktor.
A hívó nem tud aktiválási attribútumokat megadni egy olyan objektumhoz, amely nem öröklődik.MarshalByRefObject
-vagy-
securityAttributes nem null. Ha az örökölt CAS-szabályzat nincs engedélyezve, securityAttributesnull
typeName nem található a következőben assemblyName: .
Ez a példány .null
Megjegyzések
Lásd AssemblyName a formátumot assemblyName.
Ha olyan célalkalmazás-tartományt próbál meghívni CreateInstance , amely nem az aktuális alkalmazástartomány, a szerelvény sikeres betöltését eredményezi a célalkalmazás-tartományban. Assembly Mivel ez a metódus nem MarshalByRefObject, amikor ez a metódus megpróbálja visszaadni a Assembly betöltött szerelvényt az aktuális alkalmazástartományba, a közös nyelvi futtatókörnyezet megpróbálja betölteni a szerelvényt az aktuális alkalmazástartományba, és a terhelés sikertelen lehet. Az aktuális alkalmazástartományba betöltött szerelvény eltérhet az elsőként betöltött szerelvénytől, ha a két alkalmazástartomány elérési útja eltérő.