Activator.CreateInstance Methode

Definition

Namespace:

System

Assemblys:

netstandard.dll, System.Runtime.dll

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

Überlädt

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

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

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")>]
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 benannte typeName Typ gesucht wird. Wenn assemblyName ja null, 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 typeName die Groß-/Kleinschreibung nicht beachtet wird. false Wenn Sie angeben möchten, dass bei der Suche die Groß-/Kleinschreibung beachtet wird.

bindingAttr

BindingFlags

Eine Kombination aus Null- oder mehr Bitkennzeichnungen, die sich auf die Suche nach dem typeName Konstruktor auswirken. Wenn bindingAttr null ist, wird eine Groß-/Kleinschreibungssuche nach öffentlichen Konstruktoren durchgeführt.

binder

Binder

Ein Objekt, das den typeName Konstruktor verwendet bindingAttr und args identifiziert. Ist binder dies nullder Grund, wird der Standardordner verwendet.

args

Object[]

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

culture

CultureInfo

Kulturspezifische Informationen, die die Koersion der args für den typeName Konstruktor deklarierten formalen Typen steuern. Ist culture dies nullder Grund, wird der CultureInfo aktuelle 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 oder null für Nullable<T> Instanzen ohne Wert aufgehoben werden muss.

Attribute

RequiresUnreferencedCodeAttribute

Ausnahmen

ArgumentNullException

typeName ist null.

MissingMethodException

Es wurde kein übereinstimmende Konstruktor gefunden.

TypeLoadException

typeName wurde nicht gefunden in assemblyName.

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

NotSupportedException

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

-oder-

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

-oder-

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

BadImageFormatException

assemblyName ist keine gültige Assembly.

-oder-

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

Wird verwendet ObjectHandle.Unwrap , um den Rückgabewert aufzuheben.

In .NET Core 3.0 und höheren Versionen werden Assemblylasten, die von dieser API ausgelöst werden, vom aktuellen Wert von AssemblyLoadContext.CurrentContextualReflectionContext.

Anmerkung

Diese Methode kann verwendet werden, um nichtublice Typen und Member zu erstellen, wenn der Aufrufer mit dem ReflectionPermissionFlag.RestrictedMemberAccess Flag erteilt ReflectionPermission wurde und wenn der Grant-Satz der Assembly, die die nichtublicen Typen und Member enthält, auf den Grant-Satz des Aufrufers oder auf eine Teilmenge davon beschränkt ist. (Siehe Security Considerations for 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 Bitkennzeichnungen, die sich auf die Suche nach dem type Konstruktor auswirken. Wenn bindingAttr null ist, wird eine Groß-/Kleinschreibungssuche nach öffentlichen Konstruktoren durchgeführt.

binder

Binder

Ein Objekt, das den type Konstruktor verwendet bindingAttr und args identifiziert. Ist binder dies nullder Grund, wird der Standardordner verwendet.

args

Object[]

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

culture

CultureInfo

Kulturspezifische Informationen, die die Koersion der args für den type Konstruktor deklarierten formalen Typen steuern. Ist culture dies nullder Grund, wird der CultureInfo aktuelle 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 kein RuntimeType.

-oder-

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

NotSupportedException

type kann TypeBuilderkein .

-oder-

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

-oder-

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

-oder-

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

-oder-

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

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

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

Diese Methode kann verwendet werden, um auf nicht öffentliche Typen und Member zuzugreifen, wenn der Aufrufer mit der ReflectionPermissionFlag.RestrictedMemberAccess Kennzeichnung gewährt ReflectionPermission 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 Security Considerations for 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 Bitkennzeichnungen, die sich auf die Suche nach dem type Konstruktor auswirken. Wenn bindingAttr null ist, wird eine Groß-/Kleinschreibungssuche nach öffentlichen Konstruktoren durchgeführt.

binder

Binder

Ein Objekt, das den type Konstruktor verwendet bindingAttr und args identifiziert. Ist binder dies nullder Grund, wird der Standardordner verwendet.

args

Object[]

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

culture

CultureInfo

Kulturspezifische Informationen, die die Koersion der args für den type Konstruktor deklarierten formalen Typen steuern. Ist culture dies nullder Grund, wird der CultureInfo aktuelle 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 kein RuntimeType.

-oder-

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

NotSupportedException

type kann TypeBuilderkein .

-oder-

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

-oder-

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

-oder-

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

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

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

Diese Methode kann verwendet werden, um auf nicht öffentliche Typen und Member zuzugreifen, wenn der Aufrufer mit dem ReflectionPermissionFlag.RestrictedMemberAccess Flag gewährt ReflectionPermission wurde und wenn der Grant-Satz der Assembly, die die nichtublicen Typen und Member enthält, auf den Grant-Satz des Aufrufers oder auf eine Teilmenge davon beschränkt ist. (Siehe Security Considerations for 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 es sich um ein leeres Array oder nulleinen Konstruktor handelt, der keine Parameter (den parameterlosen Konstruktor) verwendet, wird aufgerufen.

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 kein RuntimeType.

-oder-

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

NotSupportedException

type kann TypeBuilderkein .

-oder-

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

-oder-

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

-oder-

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

-oder-

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

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

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

Diese Methode kann verwendet werden, um auf nicht öffentliche Typen zuzugreifen, wenn der Aufrufer mit dem ReflectionPermissionFlag.RestrictedMemberAccess Flag erteilt ReflectionPermission 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 Security Considerations for 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);

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

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")>]
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 benannte typeName Typ gesucht wird. Wenn assemblyName ja null, 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 oder null für Nullable<T> Instanzen entwappt werden muss.

Attribute

RequiresUnreferencedCodeAttribute

Ausnahmen

ArgumentNullException

typeName ist null.

MissingMethodException

Es wurde kein übereinstimmener öffentlicher Konstruktor gefunden.

TypeLoadException

typeName wurde nicht gefunden in assemblyName.

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

NotSupportedException

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

-oder-

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

-oder-

activationAttributes ist kein UrlAttribute

Anordnung.

BadImageFormatException

assemblyName ist keine gültige Assembly.

-oder-

Die Common Language Runtime (CLR) Version 2.0 oder höher wird derzeit geladen und assemblyName 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 activationAttributesder Datei angegebenen Ziel.

Hinweise

Wird verwendet ObjectHandle.Unwrap , um den Rückgabewert aufzuheben.

In .NET Core 3.0 und höheren Versionen werden Assemblylasten, die von dieser API ausgelöst werden, vom aktuellen Wert von AssemblyLoadContext.CurrentContextualReflectionContext.

Anmerkung

Diese Methode kann verwendet werden, um nicht-öffentliche Typen zu erstellen, wenn der Aufrufer mit dem ReflectionPermissionFlag.RestrictedMemberAccess Flag erteilt ReflectionPermission wurde und wenn der Grant-Satz der nichtublic-Typen auf den Grant-Satz des Aufrufers oder auf eine Teilmenge davon beschränkt ist. (Siehe Security Considerations for 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 es sich um ein leeres Array oder nulleinen Konstruktor handelt, der keine Parameter (den parameterlosen Konstruktor) verwendet, wird aufgerufen.

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 kein RuntimeType.

-oder-

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

NotSupportedException

type kann TypeBuilderkein .

-oder-

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

-oder-

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

-oder-

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

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

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.

Beispiele

Im folgenden Beispiel wird die CreateInstance(Type, Object[]) Methode zum Erstellen eines String Objekts aufgerufen. Er 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

Diese Methode kann verwendet werden, um auf nicht öffentliche Typen zuzugreifen, wenn der Aufrufer mit dem ReflectionPermissionFlag.RestrictedMemberAccess Flag erteilt ReflectionPermission 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 Security Considerations for 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 lizenzierter 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 kein RuntimeType.

-oder-

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

NotSupportedException

type kann TypeBuilderkein .

-oder-

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

-oder-

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

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

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

Diese Methode kann verwendet werden, um auf nicht öffentliche Typen und Member zuzugreifen, wenn der Aufrufer mit dem ReflectionPermissionFlag.RestrictedMemberAccess Flag gewährt ReflectionPermission wurde und wenn der Grant-Satz der Assembly, die die nichtublicen Typen und Member enthält, auf den Grant-Satz des Aufrufers oder auf eine Teilmenge davon beschränkt ist. (Siehe Security Considerations for 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);

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

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")>]
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 benannte typeName Typ gesucht wird. Wenn assemblyName ja null, 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 oder null für Nullable<T> Instanzen entwappt werden muss.

Attribute

RequiresUnreferencedCodeAttribute

Ausnahmen

ArgumentNullException

typeName ist null.

MissingMethodException

Es wurde kein übereinstimmener öffentlicher Konstruktor gefunden.

TypeLoadException

typeName wurde nicht gefunden in assemblyName.

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

NotSupportedException

Das Erstellen von TypedReference, ArgIterator, Void, und 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 derzeit geladen und assemblyName 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 definiert, die in einer Assembly mit dem Namen benannt Person ist PersonInfo. Beachten Sie, dass die Person Klasse über zwei Konstruktoren verfügt, 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 seiner Eigenschaft einen Wert zu Name .

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

Wird jedoch häufig aufgerufen, um einen Typ zu instanziieren, CreateInstance der computerübergreifende Grenzen ü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 Eigenschaft des PersonName 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

Wird verwendet ObjectHandle.Unwrap , um den Rückgabewert aufzuheben.

assemblyName kann eine der folgenden Sein:

• Der einfache Name einer Assembly ohne Pfad oder Dateierweiterung. Beispielsweise würden Sie für eine Assembly angeben TypeExtensions , deren Pfad und Name .\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.

In .NET Core 3.0 und höheren Versionen werden Assemblylasten, die von dieser API ausgelöst werden, vom aktuellen Wert von AssemblyLoadContext.CurrentContextualReflectionContext.

Anmerkung

Diese Methode kann verwendet werden, um nichtublice Typen zu erstellen, wenn der Aufrufer mit dem ReflectionPermissionFlag.RestrictedMemberAccess Flag erteilt ReflectionPermission wurde und wenn der Grant-Satz der Assembly, die die nichtublicen Typen enthält, auf den Grant-Satz des Aufrufers oder auf eine Teilmenge davon beschränkt ist. (Siehe Security Considerations for 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 kein RuntimeType.

-oder-

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

NotSupportedException

type kann TypeBuilderkein .

-oder-

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

-oder-

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

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

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.

Beispiele

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

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

Diese Methode kann verwendet werden, um auf nicht öffentliche Typen zuzugreifen, wenn der Aufrufer mit dem ReflectionPermissionFlag.RestrictedMemberAccess Flag erteilt ReflectionPermission 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 Security Considerations for 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>() where T : allows ref struct;

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 typ, für T den angegeben wird, verfügt nicht über einen parameterlosen Konstruktor.

Hinweise

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

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). Wenn der Typ zur Kompilierungszeit nicht bekannt ist, können Sie eine nicht generische Überladung aufrufen CreateInstance.

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