Activator.CreateInstanceFrom Metoda

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Vytvoří instanci typu, jejíž název je zadán, pomocí pojmenovaného souboru sestavení a konstruktoru, který nejlépe odpovídá zadaným parametrům.

Přetížení

CreateInstanceFrom(String, String, Object[])	Vytvoří instanci typu, jejíž název je zadán pomocí pojmenovaného souboru sestavení a konstruktoru bez parametrů.
CreateInstanceFrom(String, String)	Vytvoří instanci typu, jejíž název je zadán pomocí pojmenovaného souboru sestavení a konstruktoru bez parametrů.
CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Vytvoří instanci typu, jejíž název je zadán, pomocí pojmenovaného souboru sestavení a konstruktoru, který nejlépe odpovídá zadaným parametrům.

CreateInstanceFrom(String, String, Object[])

Zdroj:

Activator.cs

Vytvoří instanci typu, jejíž název je zadán, pomocí pojmenovaného souboru sestavení a konstruktoru bez parametrů.

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

Parametry

assemblyFile

String

Název souboru, který obsahuje sestavení, ve kterém je typ s názvem typeName hledán.

typeName

String

Název typu, pro který se má vytvořit instance.

activationAttributes

Object[]

Pole jednoho nebo několika atributů, které se mohou podílet na aktivaci. Obvykle se jedná o 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á se zachovává 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

Popisovač, který musí být rozbalený pro přístup k nově vytvořenému objektu nebo null pro Nullable<T> instance.

Výjimky

ArgumentNullException

typeName je null.

MissingMethodException

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

TypeLoadException

typename nebyla nalezena v assemblyFile.

FileNotFoundException

assemblyFile nebyla nalezena.

MethodAccessException

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

MemberAccessException

Nelze vytvořit instanci abstraktní třídy nebo byl tento člen vyvolán mechanismem pozdní vazby.

TargetInvocationException

Konstruktor, který byl vyvolán prostřednictvím reflexe, vyvolal výjimku.

NotSupportedException

activationAttributes není prázdné pole a vytvářený typ se neodvozuje z MarshalByRefObject.

SecurityException

Volající má požadovanou FileIOPermission.

BadImageFormatException

assemblyFile není platné sestavení.

-nebo-

Modul CLR (Common Language Runtime) verze 2.0 nebo novější je aktuálně načten a assemblyName byl zkompilován pro verzi MODULU CLR, která je novější než aktuálně načtená verze. Všimněte si, že rozhraní .NET Framework verze 2.0, 3.0 a 3.5 používají clr verze 2.0.

Poznámky

K rozbalení návratové ObjectHandle.Unwrap hodnoty použijte metodu .

Informace o dalších výjimkách, které mohou být vyvolány metodami naleznete v části Assembly.LoadFrom Výjimky metody a CreateInstance .

CreateInstanceFrom(String, String)

Zdroj:

Activator.cs

Vytvoří instanci typu, jejíž název je zadán, pomocí pojmenovaného souboru sestavení a konstruktoru bez parametrů.

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

Parametry

assemblyFile

String

Název souboru, který obsahuje sestavení, ve kterém je typ s názvem typeName hledán.

typeName

String

Název typu, pro který se má vytvořit instance.

Návraty

ObjectHandle

Popisovač, který musí být rozbalený pro přístup k nově vytvořenému objektu nebo null pro Nullable<T> instance.

Výjimky

ArgumentNullException

typeName je null.

MissingMethodException

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

TypeLoadException

typename nebyla nalezena v assemblyFile.

FileNotFoundException

assemblyFile nebyla nalezena.

MethodAccessException

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

MemberAccessException

Nelze vytvořit instanci abstraktní třídy nebo byl tento člen vyvolán mechanismem pozdní vazby.

TargetInvocationException

Konstruktor, který byl vyvolán prostřednictvím reflexe, vyvolal výjimku.

SecurityException

Volající má požadovanou FileIOPermission.

BadImageFormatException

assemblyFile není platné sestavení.

-nebo-

Modul CLR (Common Language Runtime) verze 2.0 nebo novější je aktuálně načten a assemblyName byl zkompilován pro verzi MODULU CLR, která je novější než aktuálně načtená verze. Všimněte si, že rozhraní .NET Framework verze 2.0, 3.0 a 3.5 používají clr verze 2.0.

Příklady

Následující příklad kódu ukazuje, jak volat metodu CreateInstanceFrom . Tento příklad kódu je součástí většího příkladu Activator pro třídu .

// 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)

Poznámky

K rozbalení návratové ObjectHandle.Unwrap hodnoty použijte metodu .

Informace o dalších výjimkách, které mohou být vyvolány metodami naleznete v části Assembly.LoadFrom Výjimky metody a CreateInstance .

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

Zdroj:

Activator.cs

Vytvoří instanci typu, jejíž název je zadán, pomocí pojmenovaného souboru sestavení a konstruktoru, který nejlépe odpovídá zadaným parametrům.

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

Parametry

assemblyFile

String

Název souboru, který obsahuje sestavení, ve kterém je typ s názvem typeName hledán.

typeName

String

Název typu, pro který se má vytvořit instance.

ignoreCase

Boolean

true zadejte, že se při typeName hledání nerozlišují malá a velká písmena. false Chcete-li určit, že se při hledání rozlišují 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 hodnota nula, provede se vyhledávání veřejných konstruktorů s rozlišováním velkých a malých písmen.

binder

Binder

Objekt, který používá bindingAttr a args k vyhledání a identifikaci konstruktoru typeName . Pokud binder je null, použije se výchozí pořadač.

args

Object[]

Pole argumentů, které odpovídají číslu, pořadí a typu parametry konstruktoru, který se má vyvolat. Pokud args je prázdné pole nebo null, je vyvolán konstruktor, který nepřijímá žádné parametry (konstruktor bez parametrů).

culture

CultureInfo

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

activationAttributes

Object[]

Pole jednoho nebo několika atributů, které se mohou podílet na aktivaci. Obvykle se jedná o 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á se zachovává 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

Popisovač, který musí být rozbalený pro přístup k nově vytvořenému objektu nebo null pro Nullable<T> instance.

Výjimky

ArgumentNullException

typeName je null.

MissingMethodException

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

TypeLoadException

typename nebyla nalezena v assemblyFile.

FileNotFoundException

assemblyFile nebyla nalezena.

MethodAccessException

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

MemberAccessException

Nelze vytvořit instanci abstraktní třídy nebo byl tento člen vyvolán mechanismem pozdní vazby.

TargetInvocationException

Konstruktor, který byl vyvolán prostřednictvím reflexe, vyvolal výjimku.

SecurityException

Volající nemá požadovanou FileIOPermission.

NotSupportedException

activationAttributes není prázdné pole a vytvářený typ se neodvozuje z MarshalByRefObject.

BadImageFormatException

assemblyFile není platné sestavení.

-nebo-

Modul CLR (Common Language Runtime) verze 2.0 nebo novější je aktuálně načten a assemblyName byl zkompilován pro verzi MODULU CLR, která je novější než aktuálně načtená verze. Všimněte si, že rozhraní .NET Framework verze 2.0, 3.0 a 3.5 používají clr verze 2.0.

Poznámky

K rozbalení návratové ObjectHandle.Unwrap hodnoty použijte metodu .

Informace o dalších výjimkách, které mohou být vyvolány metodami naleznete v části Assembly.LoadFrom Výjimky metody a CreateInstance .