Activator.CreateInstance Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Erstellt eine Instanz des angegebenen Typs mithilfe des Konstruktors, der den angegebenen Parametern am besten entspricht.

Überlädt

CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Erstellt eine Instanz des Typs, deren Name angegeben ist, unter Verwendung der benannten Assembly und des Konstruktors, der den angegebenen Parametern am besten entspricht.
CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo, Object[])	Erstellt eine Instanz des angegebenen Typs mithilfe des Konstruktors, der den angegebenen Parametern am besten entspricht.
CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo)	Erstellt eine Instanz des angegebenen Typs mithilfe des Konstruktors, der den angegebenen Parametern am besten entspricht.
CreateInstance(Type, Object[], Object[])	Erstellt eine Instanz des angegebenen Typs mithilfe des Konstruktors, der den angegebenen Parametern am besten entspricht.
CreateInstance(String, String, Object[])	Erstellt eine Instanz des Typs, deren Name angegeben ist, mithilfe des benannten Assembly- und parameterlosen Konstruktors.
CreateInstance(Type, Object[])	Erstellt eine Instanz des angegebenen Typs mithilfe des Konstruktors, der den angegebenen Parametern am besten entspricht.
CreateInstance(Type, Boolean)	Erstellt eine Instanz des angegebenen Typs mithilfe des parameterlosen Konstruktors dieses Typs.
CreateInstance(String, String)	Erstellt eine Instanz des Typs, deren Name angegeben ist, mithilfe des benannten Assembly- und parameterlosen Konstruktors.
CreateInstance(Type)	Erstellt eine Instanz des angegebenen Typs mithilfe des parameterlosen Konstruktors dieses Typs.
CreateInstance<T>()	Erstellt eine Instanz des Typs, der durch den angegebenen generischen Typparameter mit dem parameterlosen Konstruktor festgelegt wird.

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

Quelle:

Activator.RuntimeType.cs

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

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstance(System::String ^ assemblyName, 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? CreateInstance (string assemblyName, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, object?[]? args, System.Globalization.CultureInfo? culture, object?[]? activationAttributes);

static member CreateInstance : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> System.Runtime.Remoting.ObjectHandle

Public Shared Function CreateInstance (assemblyName 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

assemblyName

String

Der Name der Assembly, in der der Typ namens typeName gesucht wird. Wenn assemblyNamenullist, wird die ausgeführte Assembly durchsucht.

typeName

String

Der vollqualifizierte Name des Typs zum Erstellen einer Instanz von.

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 die neu erstellte Instanz aufgehoben werden muss, oder null für Nullable<T> Instanzen ohne Wert.

Ausnahmen

ArgumentNullException

typeName ist null.

MissingMethodException

Es wurde kein übereinstimmende Konstruktor gefunden.

TypeLoadException

typeName wurde in assemblyNamenicht gefunden.

FileNotFoundException

assemblyName 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.

InvalidComObjectException

Der COM-Typ wurde nicht über GetTypeFromProgID oder GetTypeFromCLSIDabgerufen.

NotSupportedException

Das Erstellen von TypedReference, ArgIterator, Voidund RuntimeArgumentHandle Typen oder Arrays dieser Typen wird nicht unterstützt.

-oder-

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

-oder-

Der Konstruktor, der am besten mit args übereinstimmt, weist varargs Argumente auf.

BadImageFormatException

assemblyName ist keine gültige Assembly.

-oder-

Die Common Language Runtime (CLR) Version 2.0 oder höher wird zurzeit geladen, und assemblyName 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.

FileLoadException

Eine Assembly oder ein Modul wurde zweimal mit zwei verschiedenen Nachweisen geladen.

-oder-

Der Assemblyname oder die Codebasis ist ungültig.

Hinweise

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

Anmerkung

Ab .NET Framework 2.0 kann diese Methode verwendet werden, um nichtublicische Typen und Member zu erstellen, wenn der Aufrufer ReflectionPermission mit dem Flag ReflectionPermissionFlag.RestrictedMemberAccess erteilt wurde und wenn der Grant-Satz der Assembly, die die nichtublicen Typen und Member enthält, auf die Erteilungsmenge des Aufrufers oder auf eine Teilmenge davon beschränkt ist. (Siehe Sicherheitsüberlegungen für Reflection.) Um diese Funktionalität zu verwenden, sollte Ihre Anwendung auf .NET Framework 3.5 oder höher abzielen.

CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo, Object[])

Quelle:

Activator.RuntimeType.cs

Erstellt eine Instanz des angegebenen Typs mithilfe des Konstruktors, der den angegebenen Parametern am besten entspricht.

public:
 static System::Object ^ CreateInstance(Type ^ type, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, cli::array <System::Object ^> ^ args, System::Globalization::CultureInfo ^ culture, cli::array <System::Object ^> ^ activationAttributes);

public static object? CreateInstance (Type type, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, object?[]? args, System.Globalization.CultureInfo? culture, object?[]? activationAttributes);

static member CreateInstance : Type * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> obj

Public Shared Function CreateInstance (type As Type, bindingAttr As BindingFlags, binder As Binder, args As Object(), culture As CultureInfo, activationAttributes As Object()) As Object

Parameter

type

Type

Der Typ des zu erstellenden Objekts.

bindingAttr

BindingFlags

Eine Kombination aus null oder mehr Bit-Flags, die sich auf die Suche nach dem type-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 type-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 type-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

Object

Ein Verweis auf das neu erstellte Objekt oder null für Nullable<T> Instanzen ohne Wert.

Ausnahmen

ArgumentNullException

type ist null.

ArgumentException

type ist keine RuntimeType.

-oder-

type ist ein offener generischer Typ (d. a. die ContainsGenericParameters-Eigenschaft gibt truezurück).

NotSupportedException

type kann keine TypeBuildersein.

-oder-

Das Erstellen von TypedReference, ArgIterator, Voidund RuntimeArgumentHandle Typen oder Arrays dieser Typen wird nicht unterstützt.

-oder-

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

-oder-

Die Assembly, die type enthält, ist eine dynamische Assembly, die mit Saveerstellt wurde.

-oder-

Der Konstruktor, der am besten mit args übereinstimmt, weist varargs Argumente auf.

TargetInvocationException

Der aufgerufene Konstruktor löst eine Ausnahme aus.

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.

InvalidComObjectException

Der COM-Typ wurde nicht über GetTypeFromProgID oder GetTypeFromCLSIDabgerufen.

MissingMethodException

Es wurde kein übereinstimmende Konstruktor gefunden.

COMException

type ist ein COM-Objekt, aber der Klassenbezeichner, der zum Abrufen des Typs verwendet wird, ist ungültig, oder die identifizierte Klasse ist nicht registriert.

TypeLoadException

type ist kein gültiger Typ.

Hinweise

Der aufgerufene Konstruktor muss die spezifischeste Übereinstimmung mit der angegebenen Argumentliste unter den Einschränkungen der angegebenen Ordner- und Bindungsattribute bereitstellen.

Anmerkung

Ab .NET Framework 2.0 kann diese Methode verwendet werden, um auf nichtublicische Typen und Member zuzugreifen, wenn der Aufrufer ReflectionPermission mit dem Flag ReflectionPermissionFlag.RestrictedMemberAccess erteilt wurde und wenn der Grant-Satz der nichtublic-Typen und -Member auf den Grant-Satz des Aufrufers oder auf eine Teilmenge davon beschränkt ist. (Siehe Sicherheitsüberlegungen für Reflection.) Um diese Funktionalität zu verwenden, sollte Ihre Anwendung auf .NET Framework 3.5 oder höher abzielen.

CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo)

Quelle:

Activator.cs

Erstellt eine Instanz des angegebenen Typs mithilfe des Konstruktors, der den angegebenen Parametern am besten entspricht.

public:
 static System::Object ^ CreateInstance(Type ^ type, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, cli::array <System::Object ^> ^ args, System::Globalization::CultureInfo ^ culture);

public static object? CreateInstance (Type type, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, object?[]? args, System.Globalization.CultureInfo? culture);

static member CreateInstance : Type * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo -> obj

Public Shared Function CreateInstance (type As Type, bindingAttr As BindingFlags, binder As Binder, args As Object(), culture As CultureInfo) As Object

Parameter

type

Type

Der Typ des zu erstellenden Objekts.

bindingAttr

BindingFlags

Eine Kombination aus null oder mehr Bit-Flags, die sich auf die Suche nach dem type-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 type-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 type-Konstruktor deklarierten formalen Typen regeln. Wenn culturenullist, wird die CultureInfo für den aktuellen Thread verwendet.

Gibt zurück

Object

Ein Verweis auf das neu erstellte Objekt oder null für Nullable<T> Instanzen ohne Wert.

Ausnahmen

ArgumentNullException

type ist null.

ArgumentException

type ist keine RuntimeType.

-oder-

type ist ein offener generischer Typ (d. a. die ContainsGenericParameters-Eigenschaft gibt truezurück).

NotSupportedException

type kann keine TypeBuildersein.

-oder-

Das Erstellen von TypedReference, ArgIterator, Voidund RuntimeArgumentHandle Typen oder Arrays dieser Typen wird nicht unterstützt.

-oder-

Die Assembly, die type enthält, ist eine dynamische Assembly, die mit Saveerstellt wurde.

-oder-

Der Konstruktor, der am besten mit args übereinstimmt, weist varargs Argumente auf.

TargetInvocationException

Der aufgerufene Konstruktor löst eine Ausnahme aus.

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.

InvalidComObjectException

Der COM-Typ wurde nicht über GetTypeFromProgID oder GetTypeFromCLSIDabgerufen.

MissingMethodException

Es wurde kein übereinstimmende Konstruktor gefunden.

COMException

type ist ein COM-Objekt, aber der Klassenbezeichner, der zum Abrufen des Typs verwendet wird, ist ungültig, oder die identifizierte Klasse ist nicht registriert.

TypeLoadException

type ist kein gültiger Typ.

Hinweise

Der aufgerufene Konstruktor muss die spezifischeste Übereinstimmung mit der angegebenen Argumentliste unter den Einschränkungen der angegebenen Ordner- und Bindungsattribute bereitstellen.

Anmerkung

Ab .NET Framework 2.0 kann diese Methode verwendet werden, um auf nichtublicische Typen und Member zuzugreifen, wenn der Aufrufer ReflectionPermission mit dem Flag ReflectionPermissionFlag.RestrictedMemberAccess erteilt wurde und wenn der Grant-Satz der Assembly, die die nichtublicen Typen und Member enthält, auf die Erteilungsmenge des Aufrufers oder auf eine Teilmenge davon beschränkt ist. (Siehe Sicherheitsüberlegungen für Reflection.) Um diese Funktionalität zu verwenden, sollte Ihre Anwendung auf .NET Framework 3.5 oder höher abzielen.

CreateInstance(Type, Object[], Object[])

Quelle:

Activator.cs

Erstellt eine Instanz des angegebenen Typs mithilfe des Konstruktors, der den angegebenen Parametern am besten entspricht.

public:
 static System::Object ^ CreateInstance(Type ^ type, cli::array <System::Object ^> ^ args, cli::array <System::Object ^> ^ activationAttributes);

public static object? CreateInstance (Type type, object?[]? args, object?[]? activationAttributes);

static member CreateInstance : Type * obj[] * obj[] -> obj

Public Shared Function CreateInstance (type As Type, args As Object(), activationAttributes As Object()) As Object

Parameter

type

Type

Der Typ des zu erstellenden Objekts.

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.

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

Object

Ein Verweis auf das neu erstellte Objekt oder null für Nullable<T> Instanzen ohne Wert.

Ausnahmen

ArgumentNullException

type ist null.

ArgumentException

type ist keine RuntimeType.

-oder-

type ist ein offener generischer Typ (d. a. die ContainsGenericParameters-Eigenschaft gibt truezurück).

NotSupportedException

type kann keine TypeBuildersein.

-oder-

Das Erstellen von TypedReference, ArgIterator, Voidund RuntimeArgumentHandle Typen oder Arrays dieser Typen wird nicht unterstützt.

-oder-

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

-oder-

Die Assembly, die type enthält, ist eine dynamische Assembly, die mit Saveerstellt wurde.

-oder-

Der Konstruktor, der am besten mit args übereinstimmt, weist varargs Argumente auf.

TargetInvocationException

Der aufgerufene Konstruktor löst eine Ausnahme aus.

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.

InvalidComObjectException

Der COM-Typ wurde nicht über GetTypeFromProgID oder GetTypeFromCLSIDabgerufen.

MissingMethodException

Es wurde kein übereinstimmener öffentlicher Konstruktor gefunden.

COMException

type ist ein COM-Objekt, aber der Klassenbezeichner, der zum Abrufen des Typs verwendet wird, ist ungültig, oder die identifizierte Klasse ist nicht registriert.

TypeLoadException

type ist kein gültiger Typ.

Hinweise

Auf den aufgerufenen Konstruktor muss zugegriffen werden kann und die spezifischste Übereinstimmung mit der angegebenen Argumentliste bereitstellen.

Anmerkung

Ab .NET Framework 2.0 kann diese Methode für den Zugriff auf nichtublic-Typen verwendet werden, wenn der Aufrufer ReflectionPermission mit dem flag ReflectionPermissionFlag.RestrictedMemberAccess erteilt wurde und wenn der Grant-Satz der Assembly, die die nichtublic-Typen enthält, auf den Grant-Satz des Aufrufers oder auf eine Teilmenge davon beschränkt ist. (Siehe Sicherheitsüberlegungen für Reflection.) Um diese Funktionalität zu verwenden, sollte Ihre Anwendung auf .NET Framework 3.5 oder höher abzielen.

CreateInstance(String, String, Object[])

Quelle:

Activator.RuntimeType.cs

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

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstance(System::String ^ assemblyName, System::String ^ typeName, cli::array <System::Object ^> ^ activationAttributes);

public static System.Runtime.Remoting.ObjectHandle? CreateInstance (string assemblyName, string typeName, object?[]? activationAttributes);

static member CreateInstance : string * string * obj[] -> System.Runtime.Remoting.ObjectHandle

Public Shared Function CreateInstance (assemblyName As String, typeName As String, activationAttributes As Object()) As ObjectHandle

Parameter

assemblyName

String

Der Name der Assembly, in der der Typ namens typeName gesucht wird. Wenn assemblyNamenullist, wird die ausgeführte Assembly durchsucht.

typeName

String

Der vollqualifizierte Name des Typs zum Erstellen einer Instanz von.

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 assemblyNamenicht gefunden.

FileNotFoundException

assemblyName 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.

InvalidComObjectException

Der COM-Typ wurde nicht über GetTypeFromProgID oder GetTypeFromCLSIDabgerufen.

NotSupportedException

Das Erstellen von TypedReference, ArgIterator, Voidund RuntimeArgumentHandle Typen oder Arrays dieser Typen wird nicht unterstützt.

-oder-

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

-oder-

activationAttributes ist keine UrlAttribute

Anordnung.

BadImageFormatException

assemblyName ist keine gültige Assembly.

-oder-

Die Common Language Runtime (CLR) Version 2.0 oder höher wird zurzeit geladen, und assemblyName 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.

FileLoadException

Eine Assembly oder ein Modul wurde zweimal mit zwei verschiedenen Nachweisen geladen.

-oder-

Der Assemblyname oder die Codebasis ist ungültig.

TargetInvocationException

Der aufgerufene Konstruktor löst eine Ausnahme aus.

-oder-

Fehler beim Versuch der Remoteaktivierung in einem in activationAttributesangegebenen Ziel.

Hinweise

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

Anmerkung

Ab .NET Framework 2.0 kann diese Methode verwendet werden, um nichtublice Typen zu erstellen, wenn der Aufrufer ReflectionPermission mit dem flag ReflectionPermissionFlag.RestrictedMemberAccess erteilt wurde und wenn der Grant-Satz der nichtublic-Typen auf den Grant-Satz des Aufrufers oder auf eine Teilmenge davon beschränkt ist. (Siehe Sicherheitsüberlegungen für Reflection.) Um diese Funktionalität zu verwenden, sollte Ihre Anwendung auf .NET Framework 3.5 oder höher abzielen.

CreateInstance(Type, Object[])

Quelle:

Activator.cs

Erstellt eine Instanz des angegebenen Typs mithilfe des Konstruktors, der den angegebenen Parametern am besten entspricht.

public:
 static System::Object ^ CreateInstance(Type ^ type, ... cli::array <System::Object ^> ^ args);

public static object? CreateInstance (Type type, params object?[]? args);

static member CreateInstance : Type * obj[] -> obj

Public Shared Function CreateInstance (type As Type, ParamArray args As Object()) As Object

Parameter

type

Type

Der Typ des zu erstellenden Objekts.

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.

Gibt zurück

Object

Ein Verweis auf das neu erstellte Objekt oder null für Nullable<T> Instanzen ohne Wert.

Ausnahmen

ArgumentNullException

type ist null.

ArgumentException

type ist keine RuntimeType.

-oder-

type ist ein offener generischer Typ (d. a. die ContainsGenericParameters-Eigenschaft gibt truezurück).

NotSupportedException

type kann keine TypeBuildersein.

-oder-

Das Erstellen von TypedReference, ArgIterator, Voidund RuntimeArgumentHandle Typen oder Arrays dieser Typen wird nicht unterstützt.

-oder-

Die Assembly, die type enthält, ist eine dynamische Assembly, die mit Saveerstellt wurde.

-oder-

Der Konstruktor, der am besten mit args übereinstimmt, weist varargs Argumente auf.

TargetInvocationException

Der aufgerufene Konstruktor löst eine Ausnahme aus.

MethodAccessException

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

Hinweis: In .NET für Windows Store-Apps oder der Portable Class Library, erfassen Sie stattdessen die Basisklassen-Ausnahme, MemberAccessException.

MemberAccessException

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

InvalidComObjectException

Der COM-Typ wurde nicht über GetTypeFromProgID oder GetTypeFromCLSIDabgerufen.

MissingMethodException

Es wurde kein übereinstimmener öffentlicher Konstruktor gefunden.

Hinweis: In .NET für Windows Store-Apps oder der Portable Class Library, erfassen Sie stattdessen die Basisklassen-Ausnahme, MissingMemberException.

COMException

type ist ein COM-Objekt, aber der Klassenbezeichner, der zum Abrufen des Typs verwendet wird, ist ungültig, oder die identifizierte Klasse ist nicht registriert.

TypeLoadException

type ist kein gültiger Typ.

Beispiele

Im folgenden Beispiel wird die CreateInstance(Type, Object[])-Methode aufgerufen, um ein String-Objekt zu erstellen. Sie ruft den String.String(Char[], Int32, Int32)-Konstruktor auf, um eine Zeichenfolge zu instanziieren, die zehn Elemente aus einem Zeichenarray enthält, beginnend an der vierzehnten Position.

using System;

public class Example
{
   public static void Main()
   {
      // Initialize array of characters from a to z.
      char[] chars = new char[26];
      for (int ctr = 0; ctr < 26; ctr++)
         chars[ctr] = (char) (ctr + 0x0061);

      object obj = Activator.CreateInstance(typeof(string),
                                            new object[] { chars, 13, 10 } );
      Console.WriteLine(obj);
   }
}
// The example displays the following output:
//       nopqrstuvw

open System

// Initialize array of characters from a to z.
let chars = [| 'a' .. 'z' |]

let obj = Activator.CreateInstance(typeof<string>, chars[13..22])

printfn $"{obj}"

// The example displays the following output:
//       nopqrstuvw

Module Example
   Public Sub Main()
      ' Initialize array of characters from a to z.
      Dim chars(25) As Char 
      For ctr As Short = 0 To 25
         chars(ctr) = ChrW(ctr + &h0061)
      Next 
      Dim obj As Object = Activator.CreateInstance(GetType(String),
                                                   { chars, 13, 10 })
      Console.WriteLine(obj)                                          
   End Sub
End Module
' The example displays the following output:
'       nopqrstuvw

Im folgenden Beispiel wird ein gezogenes Array erstellt, dessen Elemente Argumente sind, die an einen String-Konstruktor übergeben werden sollen. Anschließend übergibt das Beispiel jedes Array an die CreateInstance(Type, Object[])-Methode, um den entsprechenden Zeichenfolgenkonstruktor aufzurufen.

using System;

public class Example
{
   public static void Main()
   {
      char[] characters = { 'a', 'b', 'c', 'd', 'e', 'f' };
      object[][] arguments = new object[3][] { new object[] { characters },
                                               new object[] { characters, 1, 4 },
                                               new object[] { characters[1], 20 } };

      for (int ctr = 0; ctr <= arguments.GetUpperBound(0); ctr++) {
         object[] args = arguments[ctr];
         object result = Activator.CreateInstance(typeof(string), args);
         Console.WriteLine("{0}: {1}", result.GetType().Name, result);
      }
   }
}
// The example displays the following output:
//    String: abcdef
//    String: bcde
//    String: bbbbbbbbbbbbbbbbbbbb

open System

let chars = [| 'a' .. 'f' |]

let arguments =
    [| chars
       chars[1..4]
       Array.create 20 chars[1] |]

for args in arguments do
    let result =
        Activator.CreateInstance(typeof<string>, args)

    printfn $"{result.GetType().Name}: {result}"

// The example displays the following output:
//    String: abcdef
//    String: bcde
//    String: bbbbbbbbbbbbbbbbbbbb

Module Example
   Public Sub Main()
      Dim characters() As Char = { "a"c, "b"c, "c"c, "d"c, "e"c, "f"c }
      Dim arguments()() As Object = new Object(2)() { New Object() { characters },
                                                      New Object() { characters, 1, 4 },
                                                      New Object() { characters(1), 20 } }

      For ctr As Integer = 0 To arguments.GetUpperBound(0)
         Dim args() As Object = arguments(ctr)
         Dim result As Object = Activator.CreateInstance(GetType(String), args)
         Console.WriteLine("{0}: {1}", result.GetType().Name, result)
      Next
   End Sub
End Module
' The example displays the following output:
'       String: abcdef
'       String: bcde
'       String: bbbbbbbbbbbbbbbbbbbb

Hinweise

Auf den aufgerufenen Konstruktor muss zugegriffen werden kann und die spezifischste Übereinstimmung mit der angegebenen Argumentliste bereitstellen.

Anmerkung

Ab .NET Framework 2.0 kann diese Methode für den Zugriff auf nichtublic-Typen verwendet werden, wenn der Aufrufer ReflectionPermission mit dem flag ReflectionPermissionFlag.RestrictedMemberAccess erteilt wurde und wenn der Grant-Satz der Assembly, die die nichtublic-Typen enthält, auf den Grant-Satz des Aufrufers oder auf eine Teilmenge davon beschränkt ist. (Siehe Sicherheitsüberlegungen für Reflection.) Um diese Funktionalität zu verwenden, sollte Ihre Anwendung auf .NET Framework 3.5 oder höher abzielen.

CreateInstance(Type, Boolean)

Quelle:

Activator.RuntimeType.cs

Erstellt eine Instanz des angegebenen Typs mithilfe des parameterlosen Konstruktors dieses Typs.

public:
 static System::Object ^ CreateInstance(Type ^ type, bool nonPublic);

public static object? CreateInstance (Type type, bool nonPublic);

static member CreateInstance : Type * bool -> obj

Public Shared Function CreateInstance (type As Type, nonPublic As Boolean) As Object

Parameter

type

Type

Der Typ des zu erstellenden Objekts.

nonPublic

Boolean

true, wenn ein öffentlicher oder nicht öffentlicher parameterloser Konstruktor übereinstimmen kann; false, wenn nur ein öffentlicher parameterloser Konstruktor übereinstimmen kann.

Gibt zurück

Object

Ein Verweis auf das neu erstellte Objekt oder null für Nullable<T> Instanzen.

Ausnahmen

ArgumentNullException

type ist null.

ArgumentException

type ist keine RuntimeType.

-oder-

type ist ein offener generischer Typ (d. a. die ContainsGenericParameters-Eigenschaft gibt truezurück).

NotSupportedException

type kann keine TypeBuildersein.

-oder-

Das Erstellen von TypedReference, ArgIterator, Voidund RuntimeArgumentHandle Typen oder Arrays dieser Typen wird nicht unterstützt.

-oder-

Die Assembly, die type enthält, ist eine dynamische Assembly, die mit Saveerstellt wurde.

TargetInvocationException

Der aufgerufene Konstruktor löst eine Ausnahme aus.

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.

InvalidComObjectException

Der COM-Typ wurde nicht über GetTypeFromProgID oder GetTypeFromCLSIDabgerufen.

MissingMethodException

Es wurde kein übereinstimmener öffentlicher Konstruktor gefunden.

COMException

type ist ein COM-Objekt, aber der Klassenbezeichner, der zum Abrufen des Typs verwendet wird, ist ungültig, oder die identifizierte Klasse ist nicht registriert.

TypeLoadException

type ist kein gültiger Typ.

Hinweise

Anmerkung

Ab .NET Framework 2.0 kann diese Methode verwendet werden, um auf nichtublicische Typen und Member zuzugreifen, wenn der Aufrufer ReflectionPermission mit dem Flag ReflectionPermissionFlag.RestrictedMemberAccess erteilt wurde und wenn der Grant-Satz der Assembly, die die nichtublicen Typen und Member enthält, auf die Erteilungsmenge des Aufrufers oder auf eine Teilmenge davon beschränkt ist. (Siehe Sicherheitsüberlegungen für Reflection.) Um diese Funktionalität zu verwenden, sollte Ihre Anwendung auf .NET Framework 3.5 oder höher abzielen.

CreateInstance(String, String)

Quelle:

Activator.RuntimeType.cs

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

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstance(System::String ^ assemblyName, System::String ^ typeName);

public static System.Runtime.Remoting.ObjectHandle? CreateInstance (string assemblyName, string typeName);

static member CreateInstance : string * string -> System.Runtime.Remoting.ObjectHandle

Public Shared Function CreateInstance (assemblyName As String, typeName As String) As ObjectHandle

Parameter

assemblyName

String

Der Name der Assembly, in der der Typ namens typeName gesucht wird. Wenn assemblyNamenullist, wird die ausgeführte Assembly durchsucht.

typeName

String

Der vollqualifizierte Name des Typs zum Erstellen einer Instanz von.

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 assemblyNamenicht gefunden.

FileNotFoundException

assemblyName wurde nicht gefunden.

MethodAccessException

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

MemberAccessException

Sie können keine Instanz einer abstrakten Klasse erstellen, oder dieses Element wurde mit einem spät gebundenen Mechanismus aufgerufen.

TargetInvocationException

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

InvalidComObjectException

Der COM-Typ wurde nicht über GetTypeFromProgID oder GetTypeFromCLSIDabgerufen.

NotSupportedException

Das Erstellen von TypedReference, ArgIterator, Voidund RuntimeArgumentHandle Typen oder Arrays dieser Typen wird nicht unterstützt.

BadImageFormatException

assemblyName ist keine gültige Assembly.

-oder-

Die Common Language Runtime (CLR) Version 2.0 oder höher wird zurzeit geladen, und assemblyName 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.

FileLoadException

Eine Assembly oder ein Modul wurde zweimal mit zwei verschiedenen Nachweisen geladen.

-oder-

Der Assemblyname oder die Codebasis ist ungültig.

Beispiele

Im folgenden Beispiel wird eine Klasse namens Person in einer Assembly namens PersonInfodefiniert. Beachten Sie, dass die Person-Klasse zwei Konstruktoren hat, von denen einer parameterlos ist.

using System;

public class Person
{
   private string _name;

   public Person()
   { }

   public Person(string name)
   {
      this._name = name;
   }

   public string Name
   { get { return this._name; }
     set { this._name = value; } }

   public override string ToString()
   {
      return this._name;
   }
}

type Person(name) =
    member val Name = name with get, set

    override this.ToString() = this.Name

    new () = Person Unchecked.defaultof<string>

Public Class Person
   Private _name As String
   
   Public Sub New()
   End Sub
   
   Public Sub New(name As String)
      Me._name = name
   End Sub
   
   Public Property Name As String
      Get
         Return Me._name
      End Get
      Set
         Me._name = value
      End Set
   End Property
   
   Public Overrides Function ToString() As String
      Return Me._name
   End Function
End Class

Im folgenden Beispiel wird die CreateInstance(String, String)-Methode aufgerufen, um die Person Klasse zu instanziieren. Zum Projekt muss ein Verweis auf PersonInfo.dll hinzugefügt werden. Da die CreateInstance(String, String)-Methode den Person Klassenparameterlosen Konstruktor aufruft, weist das Beispiel dem Name-Eigenschaft einen Wert zu.

using System;
using System.Runtime.Remoting;

public class Example
{
   public static void Main()
   {
      ObjectHandle handle = Activator.CreateInstance("PersonInfo", "Person");
      Person p = (Person) handle.Unwrap();
      p.Name = "Samuel";
      Console.WriteLine(p);
   }
}
// The example displays the following output:
//        Samuel

open System

let handle = Activator.CreateInstance("PersonInfo", "Person")
let p = handle.Unwrap() :?> Person
p.Name <- "Samuel"
printfn $"{p}"

// The example displays the following output:
//        Samuel

Imports System.Runtime.Remoting

Module Example
   Public Sub Main()
      Dim handle As ObjectHandle = Activator.CreateInstance("PersonInfo", "Person")
      Dim p As Person = CType(handle.Unwrap(), Person)
      p.Name = "Samuel"
      Console.WriteLine(p)
   End Sub
End Module
' The example displays the following output:
'       Samuel

CreateInstance wird jedoch häufig aufgerufen, um einen Typ zu instanziieren, der Computergrenzen überschreitet oder die zur Entwurfszeit nicht bekannt ist. In diesem Fall können Sie keinen Verweis auf die Assembly in das Projekt aufnehmen und keine früh gebundenen Aufrufe an die Member des Typs vornehmen. Um diese Einschränkung zu umgehen, verwendet das folgende Beispiel die CreateInstance-Methode zusammen mit Spiegelung, um der Person-Eigenschaft des Name Objekts einen Wert zuzuweisen und seinen Wert anzuzeigen.

using System;
using System.Reflection;
using System.Runtime.Remoting;

public class Example
{
   public static void Main()
   {
      ObjectHandle handle = Activator.CreateInstance("PersonInfo", "Person");
      object p = handle.Unwrap();
      Type t = p.GetType();
      PropertyInfo prop = t.GetProperty("Name");
      if (prop != null)
         prop.SetValue(p, "Samuel");

      MethodInfo method = t.GetMethod("ToString");
      object retVal = method.Invoke(p, null);
      if (retVal != null)
         Console.WriteLine(retVal);
   }
}
// The example displays the following output:
//        Samuel

open System

let handle =
    Activator.CreateInstance("PersonInfo", "Person")

let p = handle.Unwrap()
let t = p.GetType()
let prop = t.GetProperty "Name"

if not (isNull prop) then
    prop.SetValue(p, "Samuel")

let method = t.GetMethod "ToString"
let retVal = method.Invoke(p, null)

if not (isNull retVal) then
    printfn $"{retVal}"

// The example displays the following output:
//        Samuel

Imports System.Reflection
Imports System.Runtime.Remoting

Module Example
   Public Sub Main()
      Dim handle As ObjectHandle = Activator.CreateInstance("PersonInfo", "Person")
      Dim p As Object = handle.Unwrap()
      Dim t As Type = p.GetType()
      Dim prop As PropertyInfo = t.GetProperty("Name")
      if Not prop Is Nothing Then
         prop.SetValue(p, "Samuel")
      End If   
      Dim method As MethodInfo = t.GetMethod("ToString")
      Dim retVal As Object = method.Invoke(p, Nothing) 
      If Not retVal Is Nothing Then
         Console.WriteLine(retVal)
      End If
   End Sub
End Module
' The example displays the following output:
'       Samuel

Hinweise

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

assemblyName kann eine der folgenden Sein:

• Der einfache Name einer Assembly ohne Pfad oder Dateierweiterung. Sie würden z. B. TypeExtensions für eine Assembly angeben, deren Pfad und Name lautet.\bin\TypeExtensions.dll.

• Der vollständige Name einer signierten Assembly, die aus dem einfachen Namen, der Version, der Kultur und dem öffentlichen Schlüsseltoken besteht; Beispiel: "TypeExtensions, Version=1.0.0.0, Culture=neutral, PublicKeyToken=181869f2f7435b51".

Weitere Informationen dazu, wie die Common Language Runtime Assemblys identifiziert und lädt, finden Sie unter How the Runtime Locates Assemblies. Informationen zur Verwendung der Anwendungskonfigurationsdatei zum Definieren von Assemblyspeicherorten finden Sie unter Angeben des Speicherorts einer Assembly. Wenn assemblyName gefunden wird, wird sie im Standardkontext geladen.

Anmerkung

Ab .NET Framework 2.0 kann diese Methode verwendet werden, um nichtublicische Typen zu erstellen, wenn der Aufrufer ReflectionPermission mit dem flag ReflectionPermissionFlag.RestrictedMemberAccess erteilt wurde und wenn der Grant-Satz der Assembly, die die nichtublic-Typen enthält, auf den Grant-Satz des Aufrufers oder auf eine Teilmenge davon beschränkt ist. (Siehe Sicherheitsüberlegungen für Reflection.) Um diese Funktionalität zu verwenden, sollte Ihre Anwendung auf .NET Framework 3.5 oder höher abzielen.

CreateInstance(Type)

Quelle:

Activator.cs

Erstellt eine Instanz des angegebenen Typs mithilfe des parameterlosen Konstruktors dieses Typs.

public:
 static System::Object ^ CreateInstance(Type ^ type);

public static object? CreateInstance (Type type);

static member CreateInstance : Type -> obj

Public Shared Function CreateInstance (type As Type) As Object

Parameter

type

Type

Der Typ des zu erstellenden Objekts.

Gibt zurück

Object

Ein Verweis auf das neu erstellte Objekt oder null für Nullable<T> Instanzen.

Ausnahmen

ArgumentNullException

type ist null.

ArgumentException

type ist keine RuntimeType.

-oder-

type ist ein offener generischer Typ (d. a. die ContainsGenericParameters-Eigenschaft gibt truezurück).

NotSupportedException

type kann keine TypeBuildersein.

-oder-

Das Erstellen von TypedReference, ArgIterator, Voidund RuntimeArgumentHandle Typen oder Arrays dieser Typen wird nicht unterstützt.

-oder-

Die Assembly, die type enthält, ist eine dynamische Assembly, die mit Saveerstellt wurde.

TargetInvocationException

Der aufgerufene Konstruktor löst eine Ausnahme aus.

MethodAccessException

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

Hinweis: In .NET für Windows Store-Apps oder der Portable Class Library, erfassen Sie stattdessen die Basisklassen-Ausnahme, MemberAccessException.

MemberAccessException

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

InvalidComObjectException

Der COM-Typ wurde nicht über GetTypeFromProgID oder GetTypeFromCLSIDabgerufen.

MissingMethodException

Es wurde kein übereinstimmener öffentlicher Konstruktor gefunden.

Hinweis: In .NET für Windows Store-Apps oder der Portable Class Library, erfassen Sie stattdessen die Basisklassen-Ausnahme, MissingMemberException.

COMException

type ist ein COM-Objekt, aber der Klassenbezeichner, der zum Abrufen des Typs verwendet wird, ist ungültig, oder die identifizierte Klasse ist nicht registriert.

TypeLoadException

type ist kein gültiger Typ.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die CreateInstance(Type)-Methode aufgerufen wird. Instanzen verschiedener Typen werden erstellt, und deren Standardwerte werden angezeigt.

using namespace System;

ref class DynamicInstanceList
{
private:
    static String^ instanceSpec = "System.EventArgs;System.Random;" +
        "System.Exception;System.Object;System.Version";

public:
    static void Main()
    {
        array<String^>^ instances = instanceSpec->Split(';');
        Array^ instlist = Array::CreateInstance(Object::typeid, instances->Length);
        Object^ item;

        for (int i = 0; i < instances->Length; i++)
        {
            // create the object from the specification string
            Console::WriteLine("Creating instance of: {0}", instances[i]);
            item = Activator::CreateInstance(Type::GetType(instances[i]));
            instlist->SetValue(item, i);
        }
        Console::WriteLine("\nObjects and their default values:\n");
        for each (Object^ o in instlist)
        {
            Console::WriteLine("Type:     {0}\nValue:    {1}\nHashCode: {2}\n",
                o->GetType()->FullName, o->ToString(), o->GetHashCode());
        }
    }
};

int main()
{
    DynamicInstanceList::Main();
}

// This program will display output similar to the following:
//
// Creating instance of: System.EventArgs
// Creating instance of: System.Random
// Creating instance of: System.Exception
// Creating instance of: System.Object
// Creating instance of: System.Version
//
// Objects and their default values:
//
// Type:     System.EventArgs
// Value:    System.EventArgs
// HashCode: 46104728
//
// Type:     System.Random
// Value:    System.Random
// HashCode: 12289376
//
// Type:     System.Exception
// Value:    System.Exception: Exception of type 'System.Exception' was thrown.
// HashCode: 55530882
//
// Type:     System.Object
// Value:    System.Object
// HashCode: 30015890
//
// Type:     System.Version
// Value:    0.0
// HashCode: 1048575

using System;

class DynamicInstanceList
{
    private static string instanceSpec = "System.EventArgs;System.Random;" +
        "System.Exception;System.Object;System.Version";

    public static void Main()
    {
        string[] instances = instanceSpec.Split(';');
        Array instlist = Array.CreateInstance(typeof(object), instances.Length);
        object item;
        for (int i = 0; i < instances.Length; i++)
        {
            // create the object from the specification string
            Console.WriteLine("Creating instance of: {0}", instances[i]);
            item = Activator.CreateInstance(Type.GetType(instances[i]));
            instlist.SetValue(item, i);
        }
        Console.WriteLine("\nObjects and their default values:\n");
        foreach (object o in instlist)
        {
            Console.WriteLine("Type:     {0}\nValue:    {1}\nHashCode: {2}\n",
                o.GetType().FullName, o.ToString(), o.GetHashCode());
        }
    }
}

// This program will display output similar to the following:
//
// Creating instance of: System.EventArgs
// Creating instance of: System.Random
// Creating instance of: System.Exception
// Creating instance of: System.Object
// Creating instance of: System.Version
//
// Objects and their default values:
//
// Type:     System.EventArgs
// Value:    System.EventArgs
// HashCode: 46104728
//
// Type:     System.Random
// Value:    System.Random
// HashCode: 12289376
//
// Type:     System.Exception
// Value:    System.Exception: Exception of type 'System.Exception' was thrown.
// HashCode: 55530882
//
// Type:     System.Object
// Value:    System.Object
// HashCode: 30015890
//
// Type:     System.Version
// Value:    0.0
// HashCode: 1048575

open System

let instanceSpec =
    "System.EventArgs;System.Random;System.Exception;System.Object;System.Version"

let instances = instanceSpec.Split ';'
let instlist = Array.zeroCreate instances.Length
let mutable item = obj ()

for i = 0 to instances.Length - 1 do
    // create the object from the specification string
    printfn $"Creating instance of: {instances.[i]}"
    item <- Activator.CreateInstance(Type.GetType instances.[i])
    instlist.[i] <- item

printfn "\nObjects and their default values:\n"

for o in instlist do
    printfn $"Type:     {o.GetType().FullName}\nValue:    {o}\nHashCode: {o.GetHashCode()}\n"


// This program will display output similar to the following:
//
// Creating instance of: System.EventArgs
// Creating instance of: System.Random
// Creating instance of: System.Exception
// Creating instance of: System.Object
// Creating instance of: System.Version
//
// Objects and their default values:
//
// Type:     System.EventArgs
// Value:    System.EventArgs
// HashCode: 46104728
//
// Type:     System.Random
// Value:    System.Random
// HashCode: 12289376
//
// Type:     System.Exception
// Value:    System.Exception: Exception of type 'System.Exception' was thrown.
// HashCode: 55530882
//
// Type:     System.Object
// Value:    System.Object
// HashCode: 30015890
//
// Type:     System.Version
// Value:    0.0
// HashCode: 1048575

Class DynamicInstanceList
    Private Shared instanceSpec As String = "System.EventArgs;System.Random;" + _
        "System.Exception;System.Object;System.Version"

    Public Shared Sub Main()
        Dim instances() As String = instanceSpec.Split(";")
        Dim instlist As Array = Array.CreateInstance(GetType(Object), instances.Length)
        Dim item As Object

        For i As Integer = 0 To instances.Length -1
            ' create the object from the specification string
            Console.WriteLine("Creating instance of: {0}", instances(i))
            item = Activator.CreateInstance(Type.GetType(instances(i)))
            instlist.SetValue(item, i)
        Next i
        Console.WriteLine(Environment.NewLine + "Objects and their default values:" + Environment.NewLine)
        For Each o As Object In instlist
            Console.WriteLine("Type:     {0}" + Environment.NewLine + "Value:    {1}" + _
                Environment.NewLine + "HashCode: {2}" + Environment.NewLine, _
                o.GetType().FullName, o.ToString(), o.GetHashCode())
        Next o
    End Sub
End Class

' This program will display output similar to the following:
'
' Creating instance of: System.EventArgs
' Creating instance of: System.Random
' Creating instance of: System.Exception
' Creating instance of: System.Object
' Creating instance of: System.Version
'
' Objects and their default values:
'
' Type:     System.EventArgs
' Value:    System.EventArgs
' HashCode: 46104728
'
' Type:     System.Random
' Value:    System.Random
' HashCode: 12289376
'
' Type:     System.Exception
' Value:    System.Exception: Exception of type 'System.Exception' was thrown.
' HashCode: 55530882
'
' Type:     System.Object
' Value:    System.Object
' HashCode: 30015890
'
' Type:     System.Version
' Value:    0.0
' HashCode: 1048575

Hinweise

Auf den aufgerufenen Konstruktor muss zugegriffen werden kann.

Anmerkung

Ab .NET Framework 2.0 kann diese Methode für den Zugriff auf nichtublic-Typen verwendet werden, wenn der Aufrufer ReflectionPermission mit dem flag ReflectionPermissionFlag.RestrictedMemberAccess erteilt wurde und wenn der Grant-Satz der Assembly, die die nichtublic-Typen enthält, auf den Grant-Satz des Aufrufers oder auf eine Teilmenge davon beschränkt ist. (Siehe Sicherheitsüberlegungen für Reflection.) Um diese Funktionalität zu verwenden, sollte Ihre Anwendung auf .NET Framework 3.5 oder höher abzielen.

CreateInstance<T>()

Quelle:

Activator.RuntimeType.cs

Erstellt eine Instanz des Typs, der durch den angegebenen generischen Typparameter mit dem parameterlosen Konstruktor festgelegt wird.

public:
generic <typename T>
 static T CreateInstance();

public static T CreateInstance<T> ();

static member CreateInstance : unit -> 'T

Public Shared Function CreateInstance(Of T) () As T

Typparameter

T

Der zu erstellende Typ.

Gibt zurück

T

Ein Verweis auf das neu erstellte Objekt oder null für Nullable<T> Instanzen.

Ausnahmen

MissingMethodException

Eine Instanz einer abstrakten Klasse kann nicht erstellt werden, oder der für T angegebene Typ verfügt nicht über einen parameterlosen Konstruktor.

Hinweis: In .NET für Windows Store-Apps oder der Portable Class Library, erfassen Sie stattdessen die Basisklassen-Ausnahme, MissingMemberException.

Hinweise

Die CreateInstance<T>() generische Methode wird von Compilern verwendet, um die Instanziierung von Typen zu implementieren, die durch Typparameter angegeben werden. In der folgenden generischen Methode verwendet beispielsweise die Implementierung von new T() (gcnew T() in C++) die CreateInstance<T>() generische Methode.

public:
    generic <typename T> where T:gcnew()
    static T Bar()
    {
        return gcnew T();
    }

public static T Factory<T>() where T : new()
{
    return new T();
}

let factory<'T when 'T : (new: unit -> 'T)> =
    new 'T()

Public Shared Function Factory(Of T As New)() As T
    Return New T()
End Function

Im Allgemeinen gibt es keine Verwendung für die CreateInstance<T>() generische Methode im Anwendungscode, da der Typ zur Kompilierungszeit bekannt sein muss. Wenn der Typ zur Kompilierungszeit bekannt ist, kann die normale Instanziierungssyntax verwendet werden (new Operator in C#, New in Visual Basic, gcnew in C++). Wenn der Typ zur Kompilierungszeit nicht bekannt ist, können Sie eine nicht generische Überladung von CreateInstanceaufrufen.

Es gibt keine Überladungen der CreateInstance<T>() generischen Methode, die Argumentlisten verwendet, da die nicht generischen Überladungen von CreateInstance bereits spät gebundene Konstruktorauflösung bieten.