AppDomain.CreateInstance Metoda

Reference

Definice

Obor názvů:: System

Sestavení:: System.Runtime.dll

Sestavení:: System.Runtime.Extensions.dll

Sestavení:: mscorlib.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vytvoří novou instanci zadaného typu definovaného v zadaném sestavení.

Přetížení

CreateInstance(String, String)	Vytvoří novou instanci určeného typu definovaného v zadaném sestavení.
CreateInstance(String, String, Object[])	Vytvoří novou instanci určeného typu definovaného v zadaném sestavení. Parametr určuje pole atributů aktivace.
CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Vytvoří novou instanci určeného typu definovaného v zadaném sestavení. Parametry určují pořadač, příznaky vazeb, argumenty konstruktoru, informace specifické pro jazykovou verzi používané k interpretaci argumentů a volitelné aktivační atributy.
CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)	Zastaralé. Zastaralé. Vytvoří novou instanci určeného typu definovaného v zadaném sestavení. Parametry určují pořadač, příznaky vazeb, argumenty konstruktoru, informace specifické pro jazykovou verzi, které slouží k interpretaci argumentů, atributů aktivace a autorizaci k vytvoření typu.

CreateInstance(String, String)

Vytvoří novou instanci určeného typu definovaného v zadaném sestavení.

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

Parametry

assemblyName: String

Zobrazovaný název sestavení. Viz třída FullName.

typeName: String

Plně kvalifikovaný název požadovaného typu, včetně oboru názvů, ale nikoli sestavení, jak je vráceno FullName vlastností.

Návraty

ObjectHandle

Objekt, který je obálkou pro novou instanci určenou .typeName Přístup k reálnému objektu lze zajistit pouze pomocí nezabalené návratové hodnoty.

Implementuje

CreateInstance(String, String)

Výjimky

AppDomainUnloadedException

Dojde k pokusu o operaci na uvolněné doméně aplikace.

ArgumentNullException

assemblyName nebo typeName je null.

BadImageFormatException

assemblyName není platné sestavení.

-nebo-

Verze 2.0 nebo novější modulu CLR (Common Language Runtime) je aktuálně načtena a assemblyName zkompilována s novější verzí.

FileLoadException

Sestavení nebo modul byly zavedeny dvakrát se dvěma různými legitimacemi.

FileNotFoundException

assemblyName nebyl nalezen.

MethodAccessException

Volající nemá oprávnění k volání tohoto konstruktoru.

MissingMethodException

Nebyl nalezen žádný odpovídající veřejný konstruktor.

TypeLoadException

typename nebyla nalezena v assemblyNamesouboru .

NullReferenceException

Tato instance je null.

Poznámky

Tato metoda volá konstruktor bez parametrů pro typeName.

Viz AssemblyName formát assemblyName.

Pokus o volání CreateInstance cílové domény aplikace, která není aktuální doménou aplikace, způsobí úspěšné načtení sestavení v cílové doméně aplikace. Assembly Vzhledem k tomu, že není MarshalByRefObject, když se tato metoda pokusí vrátit Assembly pro načtené sestavení do aktuální domény aplikace, modul CLR (Common Language Runtime) se pokusí načíst sestavení do aktuální domény aplikace a zatížení může selhat. Pokud se nastavení cesty pro dvě domény aplikace liší, sestavení načtené do aktuální domény aplikace se může lišit od prvně načteného sestavení.

Viz také

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

Platí pro

CreateInstance(String, String, Object[])

Vytvoří novou instanci určeného typu definovaného v zadaném sestavení. Parametr určuje pole atributů aktivace.

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

Parametry

assemblyName: String

Zobrazovaný název sestavení. Viz třída FullName.

typeName: String

Plně kvalifikovaný název požadovaného typu, včetně oboru názvů, ale nikoli sestavení, jak je vráceno FullName vlastností.

activationAttributes: Object[]

Pole jednoho nebo několika atributů, které se mohou podílet na aktivaci. Obvykle pole obsahující jeden UrlAttribute objekt, který určuje adresu URL, která je nutná k aktivaci vzdáleného objektu.

Tento parametr souvisí s objekty aktivovanými klientem. Aktivace klienta je starší technologie, která je zachována kvůli zpětné kompatibilitě, ale nedoporučuje se pro nový vývoj. Distribuované aplikace by místo toho měly používat Windows Communication Foundation.

Návraty

ObjectHandle

Objekt, který je obálkou pro novou instanci určenou .typeName Přístup k reálnému objektu lze zajistit pouze pomocí nezabalené návratové hodnoty.

Implementuje

CreateInstance(String, String, Object[])

Výjimky

AppDomainUnloadedException

Dojde k pokusu o operaci na uvolněné doméně aplikace.

ArgumentNullException

assemblyName nebo typeName je null.

BadImageFormatException

assemblyName není platné sestavení.

-nebo-

Verze 2.0 nebo novější modulu CLR (Common Language Runtime) je aktuálně načtena a assemblyName zkompilována s novější verzí.

FileLoadException

Sestavení nebo modul byly zavedeny dvakrát se dvěma různými legitimacemi.

FileNotFoundException

assemblyName nebyl nalezen.

MethodAccessException

Volající nemá oprávnění k volání tohoto konstruktoru.

MissingMethodException

Nebyl nalezen žádný odpovídající veřejný konstruktor.

NotSupportedException

Volající nemůže poskytnout aktivační atributy objektu, který nedědí z MarshalByRefObject.

TypeLoadException

typename nebyla nalezena v assemblyNamesouboru .

NullReferenceException

Tato instance je null.

Poznámky

Tato metoda volá konstruktor bez parametrů pro typeName.

Viz AssemblyName formát assemblyName.

Viz také

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

Platí pro

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

Vytvoří novou instanci určeného typu definovaného v zadaném sestavení. Parametry určují pořadač, příznaky vazeb, argumenty konstruktoru, informace specifické pro jazykovou verzi používané k interpretaci argumentů a volitelné aktivační atributy.

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

Parametry

assemblyName: String

Zobrazovaný název sestavení. Viz třída FullName.

typeName: String

Plně kvalifikovaný název požadovaného typu, včetně oboru názvů, ale nikoli sestavení, jak je vráceno FullName vlastností.

ignoreCase: Boolean

Logická hodnota označující, zda se při vyhledávání mají rozlišovat malá a velká písmena.

bindingAttr: BindingFlags

Kombinace nulových nebo více bitových příznaků, které ovlivňují hledání konstruktoru typeName . Pokud bindingAttr je nula, provede se vyhledávání veřejných konstruktorů s rozlišováním malých a velkých písmen.

binder: Binder

Objekt, který umožňuje vazbu, převod typů argumentů, vyvolání členů a načtení MemberInfo objektů pomocí reflexe. Pokud binder je hodnota null, použije se výchozí pořadač.

args: Object[]

Argumenty předané konstruktoru. U tohoto pole argumentů musí odpovídat číslo, pořadí a typ parametrů volanému konstruktoru. Pokud je upřednostňovaný konstruktor bez parametrů, args musí být prázdné pole nebo null.

culture: CultureInfo

Informace specifické pro jazykovou verzi, které řídí převod args na formální typy deklarované pro typeName konstruktor. Pokud culture ano null, CultureInfo použije se pro aktuální vlákno.

activationAttributes: Object[]

Návraty

ObjectHandle

Objekt, který je obálkou pro novou instanci určenou .typeName Přístup k reálnému objektu lze zajistit pouze pomocí nezabalené návratové hodnoty.

Výjimky

AppDomainUnloadedException

Dojde k pokusu o operaci na uvolněné doméně aplikace.

ArgumentNullException

assemblyName nebo typeName je null.

BadImageFormatException

assemblyName není platné sestavení.

-nebo-

assemblyName byla zkompilována s novější verzí modulu CLR (Common Language Runtime), než je aktuálně načtená verze.

FileLoadException

Sestavení nebo modul byly zavedeny dvakrát se dvěma různými legitimacemi.

FileNotFoundException

assemblyName nebyl nalezen.

MethodAccessException

Volající nemá oprávnění k volání tohoto konstruktoru.

MissingMethodException

Nebyl nalezen žádný odpovídající konstruktor.

NotSupportedException

Volající nemůže poskytnout aktivační atributy objektu, který nedědí z MarshalByRefObject.

TypeLoadException

typename nebyla nalezena v assemblyNamesouboru .

NullReferenceException

Tato instance je null.

Poznámky

Viz AssemblyName formát assemblyName.

Viz také

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

Platí pro

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

Upozornění

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.

Upozornění

Use an overload that does not take an Evidence parameter

Vytvoří novou instanci určeného typu definovaného v zadaném sestavení. Parametry určují pořadač, příznaky vazeb, argumenty konstruktoru, informace specifické pro jazykovou verzi, které slouží k interpretaci argumentů, atributů aktivace a autorizaci k vytvoření typu.

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(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);

[System.Obsolete("Use an overload that does not take an Evidence parameter")]
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

[<System.Obsolete("Use an overload that does not take an Evidence parameter")>]
member 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("Use an overload that does not take an Evidence parameter")>]
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

Parametry

assemblyName: String

Zobrazovaný název sestavení. Viz třída FullName.

typeName: String

Plně kvalifikovaný název požadovaného typu, včetně oboru názvů, ale nikoli sestavení, jak je vráceno FullName vlastností.

ignoreCase: Boolean

Logická hodnota označující, zda se při vyhledávání mají rozlišovat malá a velká písmena.

bindingAttr: BindingFlags

binder: Binder

Objekt, který umožňuje vazbu, převod typů argumentů, vyvolání členů a načtení MemberInfo objektů pomocí reflexe. Pokud binder je hodnota null, použije se výchozí pořadač.