Activator.CreateInstanceFrom Metoda

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Vytvoří instanci typu, jehož 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, jehož 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í, kde je požadován typ pojmenovaný typeName.

typeName

String

Název typu pro vytvoření instance.

activationAttributes

Object[]

Pole jednoho nebo více atributů, které se mohou účastnit aktivace. Obvykle se jedná o pole, které obsahuje 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 nebyl v assemblyFilenalezen .

FileNotFoundException

assemblyFile nebyl nalezen.

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 pomocí mechanismu pozdní vazby.

TargetInvocationException

Konstruktor, který byl vyvolán reflexí, vyvolal výjimku.

NotSupportedException

activationAttributes není prázdné pole a typ vytvořený není odvozen z MarshalByRefObject.

SecurityException

Volající má požadované FileIOPermission.

BadImageFormatException

assemblyFile není platné sestavení.

-nebo-

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

Poznámky

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

Informace o dalších výjimkách, které lze vyvolat metodami, naleznete v části Výjimky Assembly.LoadFrom a CreateInstance metody.

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í, kde je požadován typ pojmenovaný typeName.

typeName

String

Název typu pro vytvoření 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 nebyl v assemblyFilenalezen .

FileNotFoundException

assemblyFile nebyl nalezen.

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 pomocí mechanismu pozdní vazby.

TargetInvocationException

Konstruktor, který byl vyvolán reflexí, vyvolal výjimku.

SecurityException

Volající má požadované FileIOPermission.

BadImageFormatException

assemblyFile není platné sestavení.

-nebo-

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

Příklady

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

// 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é hodnoty použijte metodu ObjectHandle.Unwrap.

Informace o dalších výjimkách, které lze vyvolat metodami, naleznete v části Výjimky Assembly.LoadFrom a CreateInstance metody.

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

Zdroj:

Activator.cs

Vytvoří instanci typu, jehož 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í, kde je požadován typ pojmenovaný typeName.

typeName

String

Název typu pro vytvoření instance.

ignoreCase

Boolean

true určit, že hledání typeName nerozlišuje malá a velká písmena; false určit, že 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 je bindingAttr 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ý používá bindingAttr a args k vyhledání a identifikaci konstruktoru typeName. Pokud je bindernull, použije se výchozí pořadač.

args

Object[]

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

culture

CultureInfo

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

activationAttributes

Object[]

Pole jednoho nebo více atributů, které se mohou účastnit aktivace. Obvykle se jedná o pole, které obsahuje 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 nebyl v assemblyFilenalezen .

FileNotFoundException

assemblyFile nebyl nalezen.

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 pomocí mechanismu pozdní vazby.

TargetInvocationException

Konstruktor, který byl vyvolán reflexí, vyvolal výjimku.

SecurityException

Volající nemá požadované FileIOPermission.

NotSupportedException

activationAttributes není prázdné pole a typ vytvořený není odvozen 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 assemblyFile byl zkompilován pro verzi modulu CLR, která je pozdější než aktuálně načtená verze. Všimněte si, že rozhraní .NET Framework verze 2.0, 3.0 a 3.5 všechny používají CLR verze 2.0.

Poznámky

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

Informace o dalších výjimkách, které lze vyvolat metodami, naleznete v části Výjimky Assembly.LoadFrom a CreateInstance metody.