Activator.CreateInstanceFrom Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, 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í

Name	Description
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);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")]
public static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom(string assemblyFile, string typeName, object?[]? activationAttributes);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")>]
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 název typeName typu.

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 obsahující jeden UrlAttribute objekt, který určuje adresu URL potřebnou 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.

Atributy

RequiresUnreferencedCodeAttribute

Výjimky

ArgumentNullException

typeName je null.

MissingMethodException

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

TypeLoadException

typeName nebyl nalezen v assemblyFilesouboru .

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, který je vytvořen, není odvozen 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 assemblyFile zkompilován pro verzi modulu CLR, která je pozdější než aktuálně načtená verze.

Poznámky

Použijte metodu ObjectHandle.Unwrap k rozbalení návratové hodnoty.

Informace o dalších výjimkách, které mohou být vyvolány metodami, naleznete v části Výjimky metody 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);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")]
public static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom(string assemblyFile, string typeName);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")>]
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 název typeName typu.

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.

Atributy

RequiresUnreferencedCodeAttribute

Výjimky

ArgumentNullException

typeName je null.

MissingMethodException

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

TypeLoadException

typeName nebyl nalezen v assemblyFilesouboru .

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ž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 assemblyFile zkompilován pro verzi modulu CLR, která je pozdější než aktuálně načtená verze.

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 uvedené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,
                                 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

Použijte metodu ObjectHandle.Unwrap k rozbalení návratové hodnoty.

Informace o dalších výjimkách, které mohou být vyvolány metodami, naleznete v části Výjimky metody 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);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")]
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);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")>]
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 název typeName typu.

typeName

String

Název typu pro vytvoření instance.

ignoreCase

Boolean

true chcete-li určit, že hledání typeName nerozlišuje malá a velká písmena; false chcete-li určit, že hledání je citlivé na 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 velkých a malých písmen.

binder

Binder

Objekt, který používá bindingAttr a args hledá a identifikuje typeName konstruktor. 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. Je-li args prázdné pole nebo null, konstruktor, který nepřijímá žádné parametry (konstruktor bez parametrů) je vyvolán.

culture

CultureInfo

Informace specifické pro jazykovou verzi, které řídí převod na args 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 více atributů, které se mohou účastnit aktivace. Obvykle se jedná o pole obsahující jeden UrlAttribute objekt, který určuje adresu URL potřebnou 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.

Atributy

RequiresUnreferencedCodeAttribute

Výjimky

ArgumentNullException

typeName je null.

MissingMethodException

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

TypeLoadException

typeName nebyl nalezen v assemblyFilesouboru .

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žadovanou .FileIOPermission

NotSupportedException

activationAttributes není prázdné pole a typ, který je 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 zkompilován pro verzi modulu CLR, která je pozdější než aktuálně načtená verze.

Poznámky

Použijte metodu ObjectHandle.Unwrap k rozbalení návratové hodnoty.

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