Activator.CreateInstanceFrom Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Erstellt eine Instanz des Typs, deren Name angegeben ist, unter Verwendung der benannten Assemblydatei und des Konstruktors, der den angegebenen Parametern am besten entspricht.

Überlädt

CreateInstanceFrom(String, String, Object[])	Erstellt eine Instanz des Typs, deren Name angegeben ist, mithilfe der benannten Assemblydatei und des parameterlosen Konstruktors.
CreateInstanceFrom(String, String)	Erstellt eine Instanz des Typs, deren Name angegeben ist, mithilfe der benannten Assemblydatei und des parameterlosen Konstruktors.
CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Erstellt eine Instanz des Typs, deren Name angegeben ist, unter Verwendung der benannten Assemblydatei und des Konstruktors, der den angegebenen Parametern am besten entspricht.

CreateInstanceFrom(String, String, Object[])

Quelle:

Activator.cs

Erstellt eine Instanz des Typs, deren Name angegeben ist, mithilfe der benannten Assemblydatei und des parameterlosen Konstruktors.

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

Parameter

assemblyFile

String

Der Name einer Datei, die eine Assembly enthält, in der der Typ typeName gesucht wird.

typeName

String

Der Name des Typs, von dem eine Instanz erstellt werden soll.

activationAttributes

Object[]

Ein Array mit einem oder mehreren Attributen, die an der Aktivierung teilnehmen können. Dies ist in der Regel ein Array, das ein einzelnes UrlAttribute-Objekt enthält, das die URL angibt, die zum Aktivieren eines Remoteobjekts erforderlich ist.

Dieser Parameter bezieht sich auf clientaktive Objekte. Die Clientaktivierung ist eine ältere Technologie, die aus Gründen der Abwärtskompatibilität beibehalten wird, für die neue Entwicklung jedoch nicht empfohlen wird. Verteilte Anwendungen sollten stattdessen Windows Communication Foundation verwenden.

Gibt zurück

ObjectHandle

Ein Handle, das für den Zugriff auf das neu erstellte Objekt aufgehoben werden muss, oder null für Nullable<T> Instanzen.

Ausnahmen

ArgumentNullException

typeName ist null.

MissingMethodException

Es wurde kein übereinstimmener öffentlicher Konstruktor gefunden.

TypeLoadException

typeName wurde in assemblyFilenicht gefunden.

FileNotFoundException

assemblyFile wurde nicht gefunden.

MethodAccessException

Der Aufrufer verfügt nicht über die Berechtigung, diesen Konstruktor aufzurufen.

MemberAccessException

Eine Instanz einer abstrakten Klasse kann nicht erstellt werden, oder dieses Element wurde mit einem spät gebundenen Mechanismus aufgerufen.

TargetInvocationException

Der Konstruktor, der durch Spiegelung aufgerufen wurde, hat eine Ausnahme ausgelöst.

NotSupportedException

activationAttributes ist kein leeres Array, und der erstellte Typ wird nicht von MarshalByRefObjectabgeleitet.

SecurityException

Der Aufrufer verfügt über die erforderliche FileIOPermission.

BadImageFormatException

assemblyFile ist keine gültige Assembly.

-oder-

Die Common Language Runtime (CLR) Version 2.0 oder höher wird zurzeit geladen, und assemblyFile wurde für eine Version der CLR kompiliert, die später als die aktuell geladene Version ist. Beachten Sie, dass die .NET Framework-Versionen 2.0, 3.0 und 3.5 alle CLR-Version 2.0 verwenden.

Hinweise

Verwenden Sie die ObjectHandle.Unwrap-Methode, um den Rückgabewert aufzuheben.

Informationen zu anderen Ausnahmen, die durch aufgerufene Methoden ausgelöst werden können, finden Sie im Abschnitt "Ausnahmen" der methoden Assembly.LoadFrom und CreateInstance.

CreateInstanceFrom(String, String)

Quelle:

Activator.cs

Erstellt eine Instanz des Typs, deren Name angegeben ist, mithilfe der benannten Assemblydatei und des parameterlosen Konstruktors.

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

Parameter

assemblyFile

String

Der Name einer Datei, die eine Assembly enthält, in der der Typ typeName gesucht wird.

typeName

String

Der Name des Typs, von dem eine Instanz erstellt werden soll.

Gibt zurück

ObjectHandle

Ein Handle, das für den Zugriff auf das neu erstellte Objekt aufgehoben werden muss, oder null für Nullable<T> Instanzen.

Ausnahmen

ArgumentNullException

typeName ist null.

MissingMethodException

Es wurde kein übereinstimmener öffentlicher Konstruktor gefunden.

TypeLoadException

typeName wurde in assemblyFilenicht gefunden.

FileNotFoundException

assemblyFile wurde nicht gefunden.

MethodAccessException

Der Aufrufer verfügt nicht über die Berechtigung, diesen Konstruktor aufzurufen.

MemberAccessException

Eine Instanz einer abstrakten Klasse kann nicht erstellt werden, oder dieses Element wurde mit einem spät gebundenen Mechanismus aufgerufen.

TargetInvocationException

Der Konstruktor, der durch Spiegelung aufgerufen wurde, hat eine Ausnahme ausgelöst.

SecurityException

Der Aufrufer verfügt über die erforderliche FileIOPermission.

BadImageFormatException

assemblyFile ist keine gültige Assembly.

-oder-

Die Common Language Runtime (CLR) Version 2.0 oder höher wird zurzeit geladen, und assemblyFile wurde für eine Version der CLR kompiliert, die später als die aktuell geladene Version ist. Beachten Sie, dass die .NET Framework-Versionen 2.0, 3.0 und 3.5 alle CLR-Version 2.0 verwenden.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die CreateInstanceFrom-Methode aufgerufen wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die Activator-Klasse bereitgestellt wird.

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

Hinweise

Verwenden Sie die ObjectHandle.Unwrap-Methode, um den Rückgabewert aufzuheben.

Informationen zu anderen Ausnahmen, die durch aufgerufene Methoden ausgelöst werden können, finden Sie im Abschnitt "Ausnahmen" der methoden Assembly.LoadFrom und CreateInstance.

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

Quelle:

Activator.cs

Erstellt eine Instanz des Typs, deren Name angegeben ist, unter Verwendung der benannten Assemblydatei und des Konstruktors, der den angegebenen Parametern am besten entspricht.

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

Parameter

assemblyFile

String

Der Name einer Datei, die eine Assembly enthält, in der der Typ typeName gesucht wird.

typeName

String

Der Name des Typs, von dem eine Instanz erstellt werden soll.

ignoreCase

Boolean

true, um anzugeben, dass bei der Suche nach typeName die Groß-/Kleinschreibung nicht beachtet wird; false, um anzugeben, dass bei der Suche die Groß-/Kleinschreibung beachtet wird.

bindingAttr

BindingFlags

Eine Kombination aus null oder mehr Bit-Flags, die sich auf die Suche nach dem typeName-Konstruktor auswirken. Wenn bindingAttr null ist, wird eine Suche zwischen Groß- und Kleinschreibung für öffentliche Konstruktoren durchgeführt.

binder

Binder

Ein Objekt, das bindingAttr und args verwendet, um den typeName-Konstruktor zu suchen und zu identifizieren. Wenn bindernullist, wird der Standardordner verwendet.

args

Object[]

Ein Array von Argumenten, die in Zahlen, Reihenfolge und Eingabe der Parameter des aufgerufenen Konstruktors übereinstimmen. Wenn args ein leeres Array oder nullist, wird der Konstruktor aufgerufen, der keine Parameter (den parameterlosen Konstruktor) verwendet.

culture

CultureInfo

Kulturspezifische Informationen, die die Koersion von args an die für den typeName-Konstruktor deklarierten formalen Typen regeln. Wenn culturenullist, wird die CultureInfo für den aktuellen Thread verwendet.

activationAttributes

Object[]

Ein Array mit einem oder mehreren Attributen, die an der Aktivierung teilnehmen können. Dies ist in der Regel ein Array, das ein einzelnes UrlAttribute-Objekt enthält, das die URL angibt, die zum Aktivieren eines Remoteobjekts erforderlich ist.

Dieser Parameter bezieht sich auf clientaktive Objekte. Die Clientaktivierung ist eine ältere Technologie, die aus Gründen der Abwärtskompatibilität beibehalten wird, für die neue Entwicklung jedoch nicht empfohlen wird. Verteilte Anwendungen sollten stattdessen Windows Communication Foundation verwenden.

Gibt zurück

ObjectHandle

Ein Handle, das für den Zugriff auf das neu erstellte Objekt aufgehoben werden muss, oder null für Nullable<T> Instanzen.

Ausnahmen

ArgumentNullException

typeName ist null.

MissingMethodException

Es wurde kein übereinstimmende Konstruktor gefunden.

TypeLoadException

typeName wurde in assemblyFilenicht gefunden.

FileNotFoundException

assemblyFile wurde nicht gefunden.

MethodAccessException

Der Aufrufer verfügt nicht über die Berechtigung, diesen Konstruktor aufzurufen.

MemberAccessException

Eine Instanz einer abstrakten Klasse kann nicht erstellt werden, oder dieses Element wurde mit einem spät gebundenen Mechanismus aufgerufen.

TargetInvocationException

Der Konstruktor, der durch Spiegelung aufgerufen wurde, hat eine Ausnahme ausgelöst.

SecurityException

Der Aufrufer verfügt nicht über den erforderlichen FileIOPermission.

NotSupportedException

activationAttributes ist kein leeres Array, und der erstellte Typ wird nicht von MarshalByRefObjectabgeleitet.

BadImageFormatException

assemblyFile ist keine gültige Assembly.

-oder-

Die Common Language Runtime (CLR) Version 2.0 oder höher wird zurzeit geladen, und assemblyFile wurde für eine Version der CLR kompiliert, die später als die aktuell geladene Version ist. Beachten Sie, dass die .NET Framework-Versionen 2.0, 3.0 und 3.5 alle CLR-Version 2.0 verwenden.

Hinweise

Verwenden Sie die ObjectHandle.Unwrap-Methode, um den Rückgabewert aufzuheben.

Informationen zu anderen Ausnahmen, die durch aufgerufene Methoden ausgelöst werden können, finden Sie im Abschnitt "Ausnahmen" der methoden Assembly.LoadFrom und CreateInstance.