Activator.CreateInstanceFrom Metódus

Definíció

Névtér:

System

Szerelvények:

netstandard.dll, System.Runtime.dll

Létrehoz egy olyan példányt, amelynek a neve meg van adva, a névvel ellátott szerelvényfájl és a megadott paramétereknek leginkább megfelelő konstruktor használatával.

Túlterhelések

Name	Description
CreateInstanceFrom(String, String, Object[])	Létrehoz egy olyan példányt, amelynek a neve meg van adva a nevesített szerelvényfájl és a paraméter nélküli konstruktor használatával.
CreateInstanceFrom(String, String)	Létrehoz egy olyan példányt, amelynek a neve meg van adva a nevesített szerelvényfájl és a paraméter nélküli konstruktor használatával.
CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Létrehoz egy olyan példányt, amelynek a neve meg van adva, a névvel ellátott szerelvényfájl és a megadott paramétereknek leginkább megfelelő konstruktor használatával.

CreateInstanceFrom(String, String, Object[])

Forrás:

Activator.cs

Létrehoz egy olyan példányt, amelynek a neve meg van adva a nevesített szerelvényfájl és a paraméter nélküli konstruktor használatával.

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

Paraméterek

assemblyFile

String

Egy olyan fájl neve, amely egy szerelvényt tartalmaz, amelyben a névvel ellátott typeName típust kérik.

typeName

String

Annak a típusnak a neve, amelyből példányt szeretne létrehozni.

activationAttributes

Object[]

Egy vagy több attribútum tömbje, amely részt vehet az aktiválásban. Ez általában egy tömb, amely egyetlen UrlAttribute objektumot tartalmaz, amely megadja a távoli objektumok 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

ObjectHandle

Egy leíró, amelyet le kell bontani az újonnan létrehozott objektum vagy null példányok Nullable<T> eléréséhez.

Attribútumok

RequiresUnreferencedCodeAttribute

Kivételek

ArgumentNullException

typeName az null.

MissingMethodException

Nem található egyező nyilvános konstruktor.

TypeLoadException

typeName nem található a következőben assemblyFile: .

FileNotFoundException

assemblyFile nem található.

MethodAccessException

A hívónak nincs engedélye a konstruktor meghívására.

MemberAccessException

Absztrakt osztály példánya nem hozható létre, vagy a rendszer későn kötési mechanizmussal meghívta ezt a tagot.

TargetInvocationException

A visszatükrözéssel meghívott konstruktor kivételt vetett ki.

NotSupportedException

activationAttributes nem üres tömb, és a létrehozott típus nem a következőből MarshalByRefObjectszármazik: .

SecurityException

A hívó rendelkezik a szükséges hívóval FileIOPermission.

BadImageFormatException

assemblyFile nem érvényes szerelvény.

-vagy-

A közös nyelvi futtatókörnyezet (CLR) 2.0-s vagy újabb verziója jelenleg betöltve van, és assemblyFile a CLR egy, a jelenleg betöltött verziónál későbbi verziójához lett lefordítva.

Megjegyzések

A metódus használatával ObjectHandle.Unwrap bontsa ki a visszatérési értéket.

A meghívott metódusok által megadható egyéb kivételekről további információt a metódusok Kivételek Assembly.LoadFrom szakaszában CreateInstance talál.

CreateInstanceFrom(String, String)

Forrás:

Activator.cs

Létrehoz egy olyan példányt, amelynek a neve meg van adva a nevesített szerelvényfájl és a paraméter nélküli konstruktor használatával.

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

Paraméterek

assemblyFile

String

Egy olyan fájl neve, amely egy szerelvényt tartalmaz, amelyben a névvel ellátott typeName típust kérik.

typeName

String

Annak a típusnak a neve, amelyből példányt szeretne létrehozni.

Válaszok

ObjectHandle

Egy leíró, amelyet le kell bontani az újonnan létrehozott objektum vagy null példányok Nullable<T> eléréséhez.

Attribútumok

RequiresUnreferencedCodeAttribute

Kivételek

ArgumentNullException

typeName az null.

MissingMethodException

Nem található egyező nyilvános konstruktor.

TypeLoadException

typeName nem található a következőben assemblyFile: .

FileNotFoundException

assemblyFile nem található.

MethodAccessException

A hívónak nincs engedélye a konstruktor meghívására.

MemberAccessException

Absztrakt osztály példánya nem hozható létre, vagy a rendszer későn kötési mechanizmussal meghívta ezt a tagot.

TargetInvocationException

A visszatükrözéssel meghívott konstruktor kivételt vetett ki.

SecurityException

A hívó rendelkezik a szükséges hívóval FileIOPermission.

BadImageFormatException

assemblyFile nem érvényes szerelvény.

-vagy-

A közös nyelvi futtatókörnyezet (CLR) 2.0-s vagy újabb verziója jelenleg betöltve van, és assemblyFile a CLR egy, a jelenleg betöltött verziónál későbbi verziójához lett lefordítva.

Példák

Az alábbi példakód bemutatja, hogyan hívhatja meg a metódust CreateInstanceFrom . Ez a példakód egy nagyobb, az Activator osztályhoz tartozó példa része.

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

Megjegyzések

A metódus használatával ObjectHandle.Unwrap bontsa ki a visszatérési értéket.

A meghívott metódusok által megadható egyéb kivételekről további információt a metódusok Kivételek Assembly.LoadFrom szakaszában CreateInstance talál.

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

Forrás:

Activator.cs

Létrehoz egy olyan példányt, amelynek a neve meg van adva, a névvel ellátott szerelvényfájl és a megadott paramétereknek leginkább megfelelő konstruktor használatával.

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

Paraméterek

assemblyFile

String

Egy olyan fájl neve, amely egy szerelvényt tartalmaz, amelyben a névvel ellátott typeName típust kérik.

typeName

String

Annak a típusnak a neve, amelyből példányt szeretne létrehozni.

ignoreCase

Boolean

true a typeName kis- és nagybetűk megkülönböztetése; false a kis- és nagybetűk megkülönböztetése.

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

Egy objektum, amely a konstruktort használja bindingAttr és args keresi és azonosítja typeName . Ha binder igen null, akkor a rendszer az alapértelmezett kötőanyagot használja.

args

Object[]

Argumentumok tömbje, amelyek számban, sorrendben és a meghívandó konstruktor paramétereinek beírásával egyeznek. Ha args üres tömb, vagy nullha a konstruktor nem használ paramétereket (a paraméter nélküli konstruktort) meghívja.

culture

CultureInfo

Kultúraspecifikus információk, amelyek a konstruktor számára args deklarált formális típusok kényszerítésére typeName 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. Ez általában egy tömb, amely egyetlen UrlAttribute objektumot tartalmaz, amely megadja a távoli objektumok 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

ObjectHandle

Egy leíró, amelyet le kell bontani az újonnan létrehozott objektum vagy null példányok Nullable<T> eléréséhez.

Attribútumok

RequiresUnreferencedCodeAttribute

Kivételek

ArgumentNullException

typeName az null.

MissingMethodException

Nem található egyező konstruktor.

TypeLoadException

typeName nem található a következőben assemblyFile: .

FileNotFoundException

assemblyFile nem található.

MethodAccessException

A hívónak nincs engedélye a konstruktor meghívására.

MemberAccessException

Absztrakt osztály példánya nem hozható létre, vagy a rendszer későn kötési mechanizmussal meghívta ezt a tagot.

TargetInvocationException

A visszatükrözéssel meghívott konstruktor kivételt vetett ki.

SecurityException

A hívó nem rendelkezik a szükséges hívóval FileIOPermission.

NotSupportedException

activationAttributes nem üres tömb, és a létrehozott típus nem a következőből MarshalByRefObjectszármazik: .

BadImageFormatException

assemblyFile nem érvényes szerelvény.

-vagy-

A közös nyelvi futtatókörnyezet (CLR) 2.0-s vagy újabb verziója jelenleg betöltve van, és assemblyFile a CLR egy, a jelenleg betöltött verziónál későbbi verziójához lett lefordítva.

Megjegyzések

A metódus használatával ObjectHandle.Unwrap bontsa ki a visszatérési értéket.

A meghívott metódusok által megadható egyéb kivételekről további információt a metódusok Kivételek Assembly.LoadFrom szakaszában CreateInstance talál.