Partager via


Activator.CreateInstance Méthode

Définition

Crée une instance du type spécifié à l’aide du constructeur qui correspond le mieux aux paramètres spécifiés.

Surcharges

Nom Description
CreateInstance(AppDomain, String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)
Obsolète.

Crée une instance du type dont le nom est spécifié dans le domaine distant spécifié, à l’aide de l’assembly nommé et du constructeur qui correspond le mieux aux paramètres spécifiés.

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

Crée une instance du type dont le nom est spécifié dans le domaine distant spécifié, à l’aide de l’assembly nommé et du constructeur qui correspond le mieux aux paramètres spécifiés.

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

Crée une instance du type dont le nom est spécifié, à l’aide de l’assembly nommé et du constructeur qui correspond le mieux aux paramètres spécifiés.

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

Crée une instance du type spécifié à l’aide du constructeur qui correspond le mieux aux paramètres spécifiés.

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

Crée une instance du type spécifié à l’aide du constructeur qui correspond le mieux aux paramètres spécifiés.

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

Crée une instance du type spécifié à l’aide du constructeur qui correspond le mieux aux paramètres spécifiés.

CreateInstance(String, String, Object[])

Crée une instance du type dont le nom est spécifié, à l’aide de l’assembly nommé et du constructeur sans paramètre.

CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)
Obsolète.

Crée une instance du type dont le nom est spécifié, à l’aide de l’assembly nommé et du constructeur qui correspond le mieux aux paramètres spécifiés.

CreateInstance(Type, Object[])

Crée une instance du type spécifié à l’aide du constructeur qui correspond le mieux aux paramètres spécifiés.

CreateInstance(Type, Boolean)

Crée une instance du type spécifié à l’aide du constructeur sans paramètre de ce type.

CreateInstance(String, String)

Crée une instance du type dont le nom est spécifié, à l’aide de l’assembly nommé et du constructeur sans paramètre.

CreateInstance(ActivationContext, String[])

Crée une instance du type désigné par l’objet spécifié ActivationContext et activée avec les données d’activation personnalisées spécifiées.

CreateInstance(Type)

Crée une instance du type spécifié à l’aide du constructeur sans paramètre de ce type.

CreateInstance(ActivationContext)

Crée une instance du type désigné par l’objet spécifié ActivationContext .

CreateInstance(AppDomain, String, String)

Crée une instance du type dont le nom est spécifié dans le domaine distant spécifié, à l’aide de l’assembly nommé et du constructeur sans paramètre.

CreateInstance<T>()

Crée une instance du type désigné par le paramètre de type générique spécifié, à l’aide du constructeur sans paramètre.

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

Attention

Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstance which does not take an Evidence parameter. See https://go.microsoft.com/fwlink/?LinkID=155570 for more information.

Crée une instance du type dont le nom est spécifié dans le domaine distant spécifié, à l’aide de l’assembly nommé et du constructeur qui correspond le mieux aux paramètres spécifiés.

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstance(AppDomain ^ domain, 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::Security::Policy::Evidence ^ securityAttributes);
public static System.Runtime.Remoting.ObjectHandle CreateInstance(AppDomain domain, string assemblyName, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes, System.Security.Policy.Evidence securityAttributes);
[System.Obsolete("Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstance which does not take an Evidence parameter. See https://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
[System.Security.SecurityCritical]
public static System.Runtime.Remoting.ObjectHandle CreateInstance(AppDomain domain, string assemblyName, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes, System.Security.Policy.Evidence securityAttributes);
static member CreateInstance : AppDomain * string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> System.Runtime.Remoting.ObjectHandle
[<System.Obsolete("Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstance which does not take an Evidence parameter. See https://go.microsoft.com/fwlink/?LinkID=155570 for more information.")>]
[<System.Security.SecurityCritical>]
static member CreateInstance : AppDomain * string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateInstance (domain As AppDomain, assemblyName As String, typeName As String, ignoreCase As Boolean, bindingAttr As BindingFlags, binder As Binder, args As Object(), culture As CultureInfo, activationAttributes As Object(), securityAttributes As Evidence) As ObjectHandle

Paramètres

domain
AppDomain

Domaine où le type nommé typeName est créé.

assemblyName
String

Nom de l’assembly dans lequel le type nommé typeName est recherché. Si assemblyName c’est nullle cas, l’assembly en cours d’exécution est recherché.

typeName
String

Nom complet du type à créer une instance.

ignoreCase
Boolean

true pour spécifier que la recherche typeName n’est pas sensible à la casse ; false pour spécifier que la recherche respecte la casse.

bindingAttr
BindingFlags

Combinaison d’indicateurs de bits zéro ou plus qui affectent la recherche du typeName constructeur. Si bindingAttr la valeur est égale à zéro, une recherche sensible à la casse pour les constructeurs publics est effectuée.

binder
Binder

Objet qui utilise bindingAttr et args recherche et identifie le typeName constructeur. Si binder c’est nullle cas, le classeur par défaut est utilisé.

args
Object[]

Tableau d’arguments correspondant au nombre, à l’ordre et au type des paramètres du constructeur à appeler. S’il args s’agit d’un tableau vide ou null, le constructeur qui ne prend aucun paramètre (le constructeur sans paramètre) est appelé.

culture
CultureInfo

Informations propres à la culture qui régissent la contrainte des args types formels déclarés pour le typeName constructeur. Si culture c’est nullle cas, le CultureInfo thread actuel est utilisé.

activationAttributes
Object[]

Tableau d’un ou plusieurs attributs pouvant participer à l’activation. Il s’agit généralement d’un tableau qui contient un seul UrlAttribute objet. Spécifie UrlAttribute l’URL requise pour activer un objet distant.

securityAttributes
Evidence

Informations utilisées pour prendre des décisions de stratégie de sécurité et accorder des autorisations de code.

Retours

Handle qui doit être décompressé pour accéder à l’objet nouvellement créé ou null pour Nullable<T> les instances sans valeur.

Attributs

Exceptions

domain ou typeName est null.

Aucun constructeur correspondant n’a été trouvé.

typeName n’a pas été trouvé dans assemblyName.

assemblyName n’a pas été trouvé.

L’appelant n’a pas l’autorisation d’appeler ce constructeur.

Impossible de créer une instance d’une classe abstraite, ou ce membre a été appelé avec un mécanisme de liaison tardive.

Le constructeur, qui a été appelé par réflexion, a levé une exception.

Le type COM n’a pas été obtenu via GetTypeFromProgID ou GetTypeFromCLSID.

La création, TypedReferenceles VoidArgIteratortypes et RuntimeArgumentHandle les tableaux de ces types n’est pas prise en charge.

-ou-

activationAttributes n’est pas un tableau vide et le type créé ne dérive pas de MarshalByRefObject.

-ou-

Le constructeur qui correspond le mieux a argsvarargs des arguments.

assemblyName n’est pas un assembly valide.

-ou-

Le Common Language Runtime (CLR) version 2.0 ou ultérieure est actuellement chargé et assemblyName a été compilé pour une version du CLR ultérieure à la version actuellement chargée. Notez que les versions .NET Framework 2.0, 3.0 et 3.5 utilisent toutes clR version 2.0.

Un assembly ou un module a été chargé deux fois avec deux preuves différentes.

-ou-

Le nom de l’assembly ou la base de code n’est pas valide.

Remarques

Utiliser CreateInstance lorsqu’un hôte doit exécuter du code dans un domaine d’application disposant d’autorisations de sécurité restreintes.

Permet ObjectHandle.Unwrap de désencapsuler la valeur de retour.

S’applique à

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

Crée une instance du type dont le nom est spécifié dans le domaine distant spécifié, à l’aide de l’assembly nommé et du constructeur qui correspond le mieux aux paramètres spécifiés.

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstance(AppDomain ^ domain, 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.Security.SecurityCritical]
public static System.Runtime.Remoting.ObjectHandle CreateInstance(AppDomain domain, string assemblyName, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes);
[<System.Security.SecurityCritical>]
static member CreateInstance : AppDomain * string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateInstance (domain As AppDomain, 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

Paramètres

domain
AppDomain

Domaine où le type nommé typeName est créé.

assemblyName
String

Nom de l’assembly dans lequel le type nommé typeName est recherché. Si assemblyName c’est nullle cas, l’assembly en cours d’exécution est recherché.

typeName
String

Nom complet du type à créer une instance.

ignoreCase
Boolean

true pour spécifier que la recherche typeName n’est pas sensible à la casse ; false pour spécifier que la recherche respecte la casse.

bindingAttr
BindingFlags

Combinaison d’indicateurs de bits zéro ou plus qui affectent la recherche du typeName constructeur. Si bindingAttr la valeur est égale à zéro, une recherche sensible à la casse pour les constructeurs publics est effectuée.

binder
Binder

Objet qui utilise bindingAttr et args recherche et identifie le typeName constructeur. Si binder c’est nullle cas, le classeur par défaut est utilisé.

args
Object[]

Tableau d’arguments correspondant au nombre, à l’ordre et au type des paramètres du constructeur à appeler. S’il args s’agit d’un tableau vide ou null, le constructeur qui ne prend aucun paramètre (le constructeur sans paramètre) est appelé.

culture
CultureInfo

Informations propres à la culture qui régissent la contrainte des args types formels déclarés pour le typeName constructeur. Si culture c’est nullle cas, le CultureInfo thread actuel est utilisé.

activationAttributes
Object[]

Tableau d’un ou plusieurs attributs pouvant participer à l’activation. Il s’agit généralement d’un tableau qui contient un objet unique UrlAttribute qui spécifie l’URL requise pour activer un objet distant.

Ce paramètre est lié aux objets activés par le client. L’activation du client est une technologie héritée qui est conservée pour la compatibilité descendante, mais qui n’est pas recommandée pour le nouveau développement. Les applications distribuées doivent plutôt utiliser Windows Communication Foundation.

Retours

Handle qui doit être décompressé pour accéder à l’objet nouvellement créé ou null pour Nullable<T> les instances sans valeur.

Attributs

Exceptions

domain ou typeName est null.

Aucun constructeur correspondant n’a été trouvé.

typeName n’a pas été trouvé dans assemblyName.

assemblyName n’a pas été trouvé.

L’appelant n’a pas l’autorisation d’appeler ce constructeur.

Impossible de créer une instance d’une classe abstraite, ou ce membre a été appelé avec un mécanisme de liaison tardive.

Le constructeur, qui a été appelé par réflexion, a levé une exception.

Le type COM n’a pas été obtenu via GetTypeFromProgID ou GetTypeFromCLSID.

La création, TypedReferenceles VoidArgIteratortypes et RuntimeArgumentHandle les tableaux de ces types n’est pas prise en charge.

-ou-

activationAttributes n’est pas un tableau vide et le type créé ne dérive pas de MarshalByRefObject.

-ou-

Le constructeur qui correspond le mieux a argsvarargs des arguments.

assemblyName n’est pas un assembly valide.

-ou-

Le Common Language Runtime (CLR) version 2.0 ou ultérieure est actuellement chargé et assemblyName a été compilé pour une version du CLR ultérieure à la version actuellement chargée. Notez que les versions .NET Framework 2.0, 3.0 et 3.5 utilisent toutes clR version 2.0.

Un assembly ou un module a été chargé deux fois avec deux preuves différentes.

-ou-

Le nom de l’assembly ou la base de code n’est pas valide.

Remarques

Utiliser CreateInstance lorsqu’un hôte doit exécuter du code dans un domaine d’application disposant d’autorisations de sécurité restreintes.

Permet ObjectHandle.Unwrap de désencapsuler la valeur de retour.

S’applique à

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

Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs

Crée une instance du type dont le nom est spécifié, à l’aide de l’assembly nommé et du constructeur qui correspond le mieux aux paramètres spécifiés.

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

Paramètres

assemblyName
String

Nom de l’assembly dans lequel le type nommé typeName est recherché. Si assemblyName c’est nullle cas, l’assembly en cours d’exécution est recherché.

typeName
String

Nom complet du type à créer une instance.

ignoreCase
Boolean

true pour spécifier que la recherche typeName n’est pas sensible à la casse ; false pour spécifier que la recherche respecte la casse.

bindingAttr
BindingFlags

Combinaison d’indicateurs de bits zéro ou plus qui affectent la recherche du typeName constructeur. Si bindingAttr la valeur est égale à zéro, une recherche sensible à la casse pour les constructeurs publics est effectuée.

binder
Binder

Objet qui utilise bindingAttr et args recherche et identifie le typeName constructeur. Si binder c’est nullle cas, le classeur par défaut est utilisé.

args
Object[]

Tableau d’arguments correspondant au nombre, à l’ordre et au type des paramètres du constructeur à appeler. S’il args s’agit d’un tableau vide ou null, le constructeur qui ne prend aucun paramètre (le constructeur sans paramètre) est appelé.

culture
CultureInfo

Informations propres à la culture qui régissent la contrainte des args types formels déclarés pour le typeName constructeur. Si culture c’est nullle cas, le CultureInfo thread actuel est utilisé.

activationAttributes
Object[]

Tableau d’un ou plusieurs attributs pouvant participer à l’activation. Il s’agit généralement d’un tableau qui contient un objet unique UrlAttribute qui spécifie l’URL requise pour activer un objet distant.

Ce paramètre est lié aux objets activés par le client. L’activation du client est une technologie héritée qui est conservée pour la compatibilité descendante, mais qui n’est pas recommandée pour le nouveau développement. Les applications distribuées doivent plutôt utiliser Windows Communication Foundation.

Retours

Handle qui doit être décompressé pour accéder à l’instance nouvellement créée ou null pour Nullable<T> les instances sans valeur.

Attributs

Exceptions

typeName a la valeur null.

Aucun constructeur correspondant n’a été trouvé.

typeName n’a pas été trouvé dans assemblyName.

assemblyName n’a pas été trouvé.

L’appelant n’a pas l’autorisation d’appeler ce constructeur.

Impossible de créer une instance d’une classe abstraite, ou ce membre a été appelé avec un mécanisme de liaison tardive.

Le constructeur, qui a été appelé par réflexion, a levé une exception.

Le type COM n’a pas été obtenu via GetTypeFromProgID ou GetTypeFromCLSID.

La création, TypedReferenceles VoidArgIteratortypes et RuntimeArgumentHandle les tableaux de ces types n’est pas prise en charge.

-ou-

activationAttributes n’est pas un tableau vide et le type créé ne dérive pas de MarshalByRefObject.

-ou-

Le constructeur qui correspond le mieux a argsvarargs des arguments.

assemblyName n’est pas un assembly valide.

-ou-

Le Common Language Runtime (CLR) version 2.0 ou ultérieure est actuellement chargé et assemblyName a été compilé pour une version du CLR ultérieure à la version actuellement chargée. Notez que les versions .NET Framework 2.0, 3.0 et 3.5 utilisent toutes clR version 2.0.

Un assembly ou un module a été chargé deux fois avec deux preuves différentes.

-ou-

Le nom de l’assembly ou la base de code n’est pas valide.

Remarques

Permet ObjectHandle.Unwrap de désencapsuler la valeur de retour.

Dans .NET Core 3.0 et versions ultérieures, les chargements d’assembly déclenchés par cette API sont affectés par la valeur actuelle de AssemblyLoadContext.CurrentContextualReflectionContext.

Note

Cette méthode peut être utilisée pour créer des types et des membres non publics si l’appelant a reçu ReflectionPermission l’indicateur ReflectionPermissionFlag.RestrictedMemberAccess et si l’ensemble d’octroi de l’assembly qui contient les types et membres non publics est limité au jeu d’octroi de l’appelant ou à un sous-ensemble de celui-ci. (Consultez Considérations relatives à la sécurité pour la réflexion.) Pour utiliser cette fonctionnalité, votre application doit cibler .NET Framework 3.5 ou version ultérieure.

S’applique à

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

Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs

Crée une instance du type spécifié à l’aide du constructeur qui correspond le mieux aux paramètres spécifiés.

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

Paramètres

type
Type

Type d’objet à créer.

bindingAttr
BindingFlags

Combinaison d’indicateurs de bits zéro ou plus qui affectent la recherche du type constructeur. Si bindingAttr la valeur est égale à zéro, une recherche sensible à la casse pour les constructeurs publics est effectuée.

binder
Binder

Objet qui utilise bindingAttr et args recherche et identifie le type constructeur. Si binder c’est nullle cas, le classeur par défaut est utilisé.

args
Object[]

Tableau d’arguments correspondant au nombre, à l’ordre et au type des paramètres du constructeur à appeler. S’il args s’agit d’un tableau vide ou null, le constructeur qui ne prend aucun paramètre (le constructeur sans paramètre) est appelé.

culture
CultureInfo

Informations propres à la culture qui régissent la contrainte des args types formels déclarés pour le type constructeur. Si culture c’est nullle cas, le CultureInfo thread actuel est utilisé.

activationAttributes
Object[]

Tableau d’un ou plusieurs attributs pouvant participer à l’activation. Il s’agit généralement d’un tableau qui contient un objet unique UrlAttribute qui spécifie l’URL requise pour activer un objet distant.

Ce paramètre est lié aux objets activés par le client. L’activation du client est une technologie héritée qui est conservée pour la compatibilité descendante, mais qui n’est pas recommandée pour le nouveau développement. Les applications distribuées doivent plutôt utiliser Windows Communication Foundation.

Retours

Référence à l’objet nouvellement créé ou null pour Nullable<T> les instances sans valeur.

Exceptions

type a la valeur null.

type n’est pas un RuntimeType.

-ou-

type est un type générique ouvert (autrement dit, la ContainsGenericParameters propriété renvoie true).

type ne peut pas être un TypeBuilder.

-ou-

La création, TypedReferenceles VoidArgIteratortypes et RuntimeArgumentHandle les tableaux de ces types n’est pas prise en charge.

-ou-

activationAttributes n’est pas un tableau vide et le type créé ne dérive pas de MarshalByRefObject.

-ou-

L’assembly qui contient type est un assembly dynamique qui a été créé avec Save.

-ou-

Le constructeur qui correspond le mieux a argsvarargs des arguments.

Le constructeur appelé lève une exception.

L’appelant n’a pas l’autorisation d’appeler ce constructeur.

Impossible de créer une instance d’une classe abstraite, ou ce membre a été appelé avec un mécanisme de liaison tardive.

Le type COM n’a pas été obtenu via GetTypeFromProgID ou GetTypeFromCLSID.

Aucun constructeur correspondant n’a été trouvé.

type est un objet COM, mais l’identificateur de classe utilisé pour obtenir le type n’est pas valide ou la classe identifiée n’est pas inscrite.

type n’est pas un type valide.

Remarques

Le constructeur à appeler doit fournir la correspondance la plus spécifique avec la liste d’arguments spécifiée sous les contraintes des attributs de liaison et de classeur spécifiés.

Note

Cette méthode peut être utilisée pour accéder aux types et membres non publics si l’appelant a été accordé ReflectionPermission avec l’indicateur ReflectionPermissionFlag.RestrictedMemberAccess et si l’ensemble d’octroi des types et membres non publics est limité au jeu d’octroi de l’appelant ou à un sous-ensemble de celui-ci. (Consultez Considérations relatives à la sécurité pour la réflexion.) Pour utiliser cette fonctionnalité, votre application doit cibler .NET Framework 3.5 ou version ultérieure.

S’applique à

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

Source:
Activator.cs
Source:
Activator.cs
Source:
Activator.cs
Source:
Activator.cs
Source:
Activator.cs

Crée une instance du type spécifié à l’aide du constructeur qui correspond le mieux aux paramètres spécifiés.

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

Paramètres

type
Type

Type d’objet à créer.

bindingAttr
BindingFlags

Combinaison d’indicateurs de bits zéro ou plus qui affectent la recherche du type constructeur. Si bindingAttr la valeur est égale à zéro, une recherche sensible à la casse pour les constructeurs publics est effectuée.

binder
Binder

Objet qui utilise bindingAttr et args recherche et identifie le type constructeur. Si binder c’est nullle cas, le classeur par défaut est utilisé.

args
Object[]

Tableau d’arguments correspondant au nombre, à l’ordre et au type des paramètres du constructeur à appeler. S’il args s’agit d’un tableau vide ou null, le constructeur qui ne prend aucun paramètre (le constructeur sans paramètre) est appelé.

culture
CultureInfo

Informations propres à la culture qui régissent la contrainte des args types formels déclarés pour le type constructeur. Si culture c’est nullle cas, le CultureInfo thread actuel est utilisé.

Retours

Référence à l’objet nouvellement créé ou null pour Nullable<T> les instances sans valeur.

Exceptions

type a la valeur null.

type n’est pas un RuntimeType.

-ou-

type est un type générique ouvert (autrement dit, la ContainsGenericParameters propriété renvoie true).

type ne peut pas être un TypeBuilder.

-ou-

La création, TypedReferenceles VoidArgIteratortypes et RuntimeArgumentHandle les tableaux de ces types n’est pas prise en charge.

-ou-

L’assembly qui contient type est un assembly dynamique qui a été créé avec Save.

-ou-

Le constructeur qui correspond le mieux a argsvarargs des arguments.

Le constructeur appelé lève une exception.

L’appelant n’a pas l’autorisation d’appeler ce constructeur.

Impossible de créer une instance d’une classe abstraite, ou ce membre a été appelé avec un mécanisme de liaison tardive.

Le type COM n’a pas été obtenu via GetTypeFromProgID ou GetTypeFromCLSID.

Aucun constructeur correspondant n’a été trouvé.

type est un objet COM, mais l’identificateur de classe utilisé pour obtenir le type n’est pas valide ou la classe identifiée n’est pas inscrite.

type n’est pas un type valide.

Remarques

Le constructeur à appeler doit fournir la correspondance la plus spécifique avec la liste d’arguments spécifiée sous les contraintes des attributs de liaison et de classeur spécifiés.

Note

Cette méthode peut être utilisée pour accéder aux types et membres non publics si l’appelant a reçu ReflectionPermission l’indicateur ReflectionPermissionFlag.RestrictedMemberAccess et si l’ensemble d’octroi de l’assembly qui contient les types et membres non publics est limité au jeu d’octroi de l’appelant ou à un sous-ensemble de celui-ci. (Consultez Considérations relatives à la sécurité pour la réflexion.) Pour utiliser cette fonctionnalité, votre application doit cibler .NET Framework 3.5 ou version ultérieure.

S’applique à

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

Source:
Activator.cs
Source:
Activator.cs
Source:
Activator.cs
Source:
Activator.cs
Source:
Activator.cs

Crée une instance du type spécifié à l’aide du constructeur qui correspond le mieux aux paramètres spécifiés.

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

Paramètres

type
Type

Type d’objet à créer.

args
Object[]

Tableau d’arguments correspondant au nombre, à l’ordre et au type des paramètres du constructeur à appeler. S’il args s’agit d’un tableau vide ou null, le constructeur qui ne prend aucun paramètre (le constructeur sans paramètre) est appelé.

activationAttributes
Object[]

Tableau d’un ou plusieurs attributs pouvant participer à l’activation. Il s’agit généralement d’un tableau qui contient un objet unique UrlAttribute qui spécifie l’URL requise pour activer un objet distant.

Ce paramètre est lié aux objets activés par le client. L’activation du client est une technologie héritée qui est conservée pour la compatibilité descendante, mais qui n’est pas recommandée pour le nouveau développement. Les applications distribuées doivent plutôt utiliser Windows Communication Foundation.

Retours

Référence à l’objet nouvellement créé ou null pour Nullable<T> les instances sans valeur.

Exceptions

type a la valeur null.

type n’est pas un RuntimeType.

-ou-

type est un type générique ouvert (autrement dit, la ContainsGenericParameters propriété renvoie true).

type ne peut pas être un TypeBuilder.

-ou-

La création, TypedReferenceles VoidArgIteratortypes et RuntimeArgumentHandle les tableaux de ces types n’est pas prise en charge.

-ou-

activationAttributes n’est pas un tableau vide et le type créé ne dérive pas de MarshalByRefObject.

-ou-

L’assembly qui contient type est un assembly dynamique qui a été créé avec Save.

-ou-

Le constructeur qui correspond le mieux a argsvarargs des arguments.

Le constructeur appelé lève une exception.

L’appelant n’a pas l’autorisation d’appeler ce constructeur.

Impossible de créer une instance d’une classe abstraite, ou ce membre a été appelé avec un mécanisme de liaison tardive.

Le type COM n’a pas été obtenu via GetTypeFromProgID ou GetTypeFromCLSID.

Aucun constructeur public correspondant n’a été trouvé.

type est un objet COM, mais l’identificateur de classe utilisé pour obtenir le type n’est pas valide ou la classe identifiée n’est pas inscrite.

type n’est pas un type valide.

Remarques

Le constructeur à appeler doit être accessible et doit fournir la correspondance la plus spécifique avec la liste d’arguments spécifiée.

Note

Cette méthode peut être utilisée pour accéder aux types non publics si l’appelant a été accordé ReflectionPermission avec l’indicateur ReflectionPermissionFlag.RestrictedMemberAccess et si le jeu d’octroi de l’assembly qui contient les types non publics est limité au jeu d’octroi de l’appelant ou à un sous-ensemble de celui-ci. (Consultez Considérations relatives à la sécurité pour la réflexion.) Pour utiliser cette fonctionnalité, votre application doit cibler .NET Framework 3.5 ou version ultérieure.

S’applique à

CreateInstance(String, String, Object[])

Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs

Crée une instance du type dont le nom est spécifié, à l’aide de l’assembly nommé et du constructeur sans paramètre.

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);
public static System.Runtime.Remoting.ObjectHandle? CreateInstance(string assemblyName, string typeName, object?[]? activationAttributes);
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
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

Paramètres

assemblyName
String

Nom de l’assembly dans lequel le type nommé typeName est recherché. Si assemblyName c’est nullle cas, l’assembly en cours d’exécution est recherché.

typeName
String

Nom complet du type à créer une instance.

activationAttributes
Object[]

Tableau d’un ou plusieurs attributs pouvant participer à l’activation. Il s’agit généralement d’un tableau qui contient un objet unique UrlAttribute qui spécifie l’URL requise pour activer un objet distant.

Ce paramètre est lié aux objets activés par le client. L’activation du client est une technologie héritée qui est conservée pour la compatibilité descendante, mais qui n’est pas recommandée pour le nouveau développement. Les applications distribuées doivent plutôt utiliser Windows Communication Foundation.

Retours

Handle qui doit être décompressé pour accéder à l’objet nouvellement créé ou null pour Nullable<T> les instances.

Attributs

Exceptions

typeName a la valeur null.

Aucun constructeur public correspondant n’a été trouvé.

typeName n’a pas été trouvé dans assemblyName.

assemblyName n’a pas été trouvé.

L’appelant n’a pas l’autorisation d’appeler ce constructeur.

Impossible de créer une instance d’une classe abstraite, ou ce membre a été appelé avec un mécanisme de liaison tardive.

Le type COM n’a pas été obtenu via GetTypeFromProgID ou GetTypeFromCLSID.

La création, TypedReferenceles VoidArgIteratortypes et RuntimeArgumentHandle les tableaux de ces types n’est pas prise en charge.

-ou-

activationAttributes n’est pas un tableau vide et le type créé ne dérive pas de MarshalByRefObject.

-ou-

activationAttributes n’est pas un UrlAttribute

tableau.

assemblyName n’est pas un assembly valide.

-ou-

Le Common Language Runtime (CLR) version 2.0 ou ultérieure est actuellement chargé et assemblyName a été compilé pour une version du CLR ultérieure à la version actuellement chargée. Notez que les versions .NET Framework 2.0, 3.0 et 3.5 utilisent toutes clR version 2.0.

Un assembly ou un module a été chargé deux fois avec deux preuves différentes.

-ou-

Le nom de l’assembly ou la base de code n’est pas valide.

Le constructeur appelé lève une exception.

-ou-

Une erreur s’est produite lors de la tentative d’activation à distance dans une cible spécifiée dans activationAttributes.

Remarques

Permet ObjectHandle.Unwrap de désencapsuler la valeur de retour.

Dans .NET Core 3.0 et versions ultérieures, les chargements d’assembly déclenchés par cette API sont affectés par la valeur actuelle de AssemblyLoadContext.CurrentContextualReflectionContext.

Note

Cette méthode peut être utilisée pour créer des types non publics si l’appelant a été accordé ReflectionPermission avec l’indicateur ReflectionPermissionFlag.RestrictedMemberAccess et si le jeu d’octroi des types non publics est limité au jeu d’octroi de l’appelant ou à un sous-ensemble de celui-ci. (Consultez Considérations relatives à la sécurité pour la réflexion.) Pour utiliser cette fonctionnalité, votre application doit cibler .NET Framework 3.5 ou version ultérieure.

S’applique à

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

Attention

Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstance which does not take an Evidence parameter. See https://go.microsoft.com/fwlink/?LinkID=155570 for more information.

Crée une instance du type dont le nom est spécifié, à l’aide de l’assembly nommé et du constructeur qui correspond le mieux aux paramètres spécifiés.

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::Security::Policy::Evidence ^ securityInfo);
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.Security.Policy.Evidence securityInfo);
[System.Obsolete("Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstance which does not take an Evidence parameter. See https://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
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.Security.Policy.Evidence securityInfo);
static member CreateInstance : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> System.Runtime.Remoting.ObjectHandle
[<System.Obsolete("Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstance which does not take an Evidence parameter. See https://go.microsoft.com/fwlink/?LinkID=155570 for more information.")>]
static member CreateInstance : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> 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(), securityInfo As Evidence) As ObjectHandle

Paramètres

assemblyName
String

Nom de l’assembly dans lequel le type nommé typeName est recherché. Si assemblyName c’est nullle cas, l’assembly en cours d’exécution est recherché.

typeName
String

Nom complet du type à créer une instance.

ignoreCase
Boolean

true pour spécifier que la recherche typeName n’est pas sensible à la casse ; false pour spécifier que la recherche respecte la casse.

bindingAttr
BindingFlags

Combinaison d’indicateurs de bits zéro ou plus qui affectent la recherche du typeName constructeur. Si bindingAttr la valeur est égale à zéro, une recherche sensible à la casse pour les constructeurs publics est effectuée.

binder
Binder

Objet qui utilise bindingAttr et args recherche et identifie le typeName constructeur. Si binder c’est nullle cas, le classeur par défaut est utilisé.

args
Object[]

Tableau d’arguments correspondant au nombre, à l’ordre et au type des paramètres du constructeur à appeler. S’il args s’agit d’un tableau vide ou null, le constructeur qui ne prend aucun paramètre (le constructeur sans paramètre) est appelé.

culture
CultureInfo

Informations propres à la culture qui régissent la contrainte des args types formels déclarés pour le typeName constructeur. Si culture c’est nullle cas, le CultureInfo thread actuel est utilisé.

activationAttributes
Object[]

Tableau d’un ou plusieurs attributs pouvant participer à l’activation. Il s’agit généralement d’un tableau qui contient un objet unique UrlAttribute qui spécifie l’URL requise pour activer un objet distant.

Ce paramètre est lié aux objets activés par le client. L’activation du client est une technologie héritée qui est conservée pour la compatibilité descendante, mais qui n’est pas recommandée pour le nouveau développement. Les applications distribuées doivent plutôt utiliser Windows Communication Foundation.

securityInfo
Evidence

Informations utilisées pour prendre des décisions de stratégie de sécurité et accorder des autorisations de code.

Retours

Handle qui doit être décompressé pour accéder à l’objet nouvellement créé ou null pour Nullable<T> les instances sans valeur.

Attributs

Exceptions

typeName a la valeur null.

Aucun constructeur correspondant n’a été trouvé.

typeName n’a pas été trouvé dans assemblyName.

assemblyName n’a pas été trouvé.

L’appelant n’a pas l’autorisation d’appeler ce constructeur.

Impossible de créer une instance d’une classe abstraite, ou ce membre a été appelé avec un mécanisme de liaison tardive.

Le constructeur, qui a été appelé par réflexion, a levé une exception.

Le type COM n’a pas été obtenu via GetTypeFromProgID ou GetTypeFromCLSID.

La création, TypedReferenceles VoidArgIteratortypes et RuntimeArgumentHandle les tableaux de ces types n’est pas prise en charge.

-ou-

activationAttributes n’est pas un tableau vide et le type créé ne dérive pas de MarshalByRefObject.

-ou-

Le constructeur qui correspond le mieux a argsvarargs des arguments.

assemblyName n’est pas un assembly valide.

-ou-

Le Common Language Runtime (CLR) version 2.0 ou ultérieure est actuellement chargé et assemblyName a été compilé pour une version du CLR ultérieure à la version actuellement chargée. Notez que les versions .NET Framework 2.0, 3.0 et 3.5 utilisent toutes clR version 2.0.

Un assembly ou un module a été chargé deux fois avec deux preuves différentes.

-ou-

Le nom de l’assembly ou la base de code n’est pas valide.

Remarques

Permet ObjectHandle.Unwrap de désencapsuler la valeur de retour.

Note

Cette méthode peut être utilisée pour créer des types et des membres non publics si l’appelant a reçu ReflectionPermission l’indicateur ReflectionPermissionFlag.RestrictedMemberAccess et si l’ensemble d’octroi de l’assembly qui contient les types et membres non publics est limité au jeu d’octroi de l’appelant ou à un sous-ensemble de celui-ci. (Consultez Considérations relatives à la sécurité pour la réflexion.) Pour utiliser cette fonctionnalité, votre application doit cibler .NET Framework 3.5 ou version ultérieure.

S’applique à

CreateInstance(Type, Object[])

Source:
Activator.cs
Source:
Activator.cs
Source:
Activator.cs
Source:
Activator.cs
Source:
Activator.cs

Crée une instance du type spécifié à l’aide du constructeur qui correspond le mieux aux paramètres spécifiés.

public:
 static System::Object ^ CreateInstance(Type ^ type, ... cli::array <System::Object ^> ^ args);
public:
 static System::Object ^ CreateInstance(Type ^ type, cli::array <System::Object ^> ^ args);
public static object CreateInstance(Type type, params object[] args);
public static object? CreateInstance(Type type, params object?[]? args);
public static object CreateInstance(Type type, object[] args);
static member CreateInstance : Type * obj[] -> obj
Public Shared Function CreateInstance (type As Type, ParamArray args As Object()) As Object
Public Shared Function CreateInstance (type As Type, args As Object()) As Object

Paramètres

type
Type

Type d’objet à créer.

args
Object[]

Tableau d’arguments correspondant au nombre, à l’ordre et au type des paramètres du constructeur à appeler. S’il args s’agit d’un tableau vide ou null, le constructeur qui ne prend aucun paramètre (le constructeur sans paramètre) est appelé.

Retours

Référence à l’objet nouvellement créé ou null pour Nullable<T> les instances sans valeur.

Exceptions

type a la valeur null.

type n’est pas un RuntimeType.

-ou-

type est un type générique ouvert (autrement dit, la ContainsGenericParameters propriété renvoie true).

type ne peut pas être un TypeBuilder.

-ou-

La création, TypedReferenceles VoidArgIteratortypes et RuntimeArgumentHandle les tableaux de ces types n’est pas prise en charge.

-ou-

L’assembly qui contient type est un assembly dynamique qui a été créé avec Save.

-ou-

Le constructeur qui correspond le mieux a argsvarargs des arguments.

Le constructeur appelé lève une exception.

L’appelant n’a pas l’autorisation d’appeler ce constructeur.

Impossible de créer une instance d’une classe abstraite, ou ce membre a été appelé avec un mécanisme de liaison tardive.

Le type COM n’a pas été obtenu via GetTypeFromProgID ou GetTypeFromCLSID.

Aucun constructeur public correspondant n’a été trouvé.

type est un objet COM, mais l’identificateur de classe utilisé pour obtenir le type n’est pas valide ou la classe identifiée n’est pas inscrite.

type n’est pas un type valide.

Exemples

L’exemple suivant appelle la CreateInstance(Type, Object[]) méthode pour créer un String objet. Il appelle le String.String(Char[], Int32, Int32) constructeur pour instancier une chaîne qui contient dix éléments d’un tableau de caractères commençant à la quatorzeème 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

L’exemple suivant crée un tableau en jaquet dont les éléments sont des arguments à passer à un String constructeur. L’exemple transmet ensuite chaque tableau à la CreateInstance(Type, Object[]) méthode pour appeler le constructeur de chaîne approprié.

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

Remarques

Le constructeur à appeler doit être accessible et doit fournir la correspondance la plus spécifique avec la liste d’arguments spécifiée.

Note

Cette méthode peut être utilisée pour accéder aux types non publics si l’appelant a été accordé ReflectionPermission avec l’indicateur ReflectionPermissionFlag.RestrictedMemberAccess et si le jeu d’octroi de l’assembly qui contient les types non publics est limité au jeu d’octroi de l’appelant ou à un sous-ensemble de celui-ci. (Consultez Considérations relatives à la sécurité pour la réflexion.) Pour utiliser cette fonctionnalité, votre application doit cibler .NET Framework 3.5 ou version ultérieure.

S’applique à

CreateInstance(Type, Boolean)

Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs

Crée une instance du type spécifié à l’aide du constructeur sans paramètre de ce type.

public:
 static System::Object ^ CreateInstance(Type ^ type, bool nonPublic);
public static 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

Paramètres

type
Type

Type d’objet à créer.

nonPublic
Boolean

true si un constructeur sans paramètre public ou non public peut correspondre ; false si seul un constructeur sans paramètre public peut correspondre.

Retours

Référence à l’objet nouvellement créé ou null pour Nullable<T> les instances.

Exceptions

type a la valeur null.

type n’est pas un RuntimeType.

-ou-

type est un type générique ouvert (autrement dit, la ContainsGenericParameters propriété renvoie true).

type ne peut pas être un TypeBuilder.

-ou-

La création, TypedReferenceles VoidArgIteratortypes et RuntimeArgumentHandle les tableaux de ces types n’est pas prise en charge.

-ou-

L’assembly qui contient type est un assembly dynamique qui a été créé avec Save.

Le constructeur appelé lève une exception.

L’appelant n’a pas l’autorisation d’appeler ce constructeur.

Impossible de créer une instance d’une classe abstraite, ou ce membre a été appelé avec un mécanisme de liaison tardive.

Le type COM n’a pas été obtenu via GetTypeFromProgID ou GetTypeFromCLSID.

Aucun constructeur public correspondant n’a été trouvé.

type est un objet COM, mais l’identificateur de classe utilisé pour obtenir le type n’est pas valide ou la classe identifiée n’est pas inscrite.

type n’est pas un type valide.

Remarques

Note

Cette méthode peut être utilisée pour accéder aux types et membres non publics si l’appelant a reçu ReflectionPermission l’indicateur ReflectionPermissionFlag.RestrictedMemberAccess et si l’ensemble d’octroi de l’assembly qui contient les types et membres non publics est limité au jeu d’octroi de l’appelant ou à un sous-ensemble de celui-ci. (Consultez Considérations relatives à la sécurité pour la réflexion.) Pour utiliser cette fonctionnalité, votre application doit cibler .NET Framework 3.5 ou version ultérieure.

S’applique à

CreateInstance(String, String)

Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs

Crée une instance du type dont le nom est spécifié, à l’aide de l’assembly nommé et du constructeur sans paramètre.

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);
public static System.Runtime.Remoting.ObjectHandle? CreateInstance(string assemblyName, string typeName);
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
static member CreateInstance : string * string -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateInstance (assemblyName As String, typeName As String) As ObjectHandle

Paramètres

assemblyName
String

Nom de l’assembly dans lequel le type nommé typeName est recherché. Si assemblyName c’est nullle cas, l’assembly en cours d’exécution est recherché.

typeName
String

Nom complet du type à créer une instance.

Retours

Handle qui doit être décompressé pour accéder à l’objet nouvellement créé ou null pour Nullable<T> les instances.

Attributs

Exceptions

typeName a la valeur null.

Aucun constructeur public correspondant n’a été trouvé.

typeName n’a pas été trouvé dans assemblyName.

assemblyName n’a pas été trouvé.

L’appelant n’a pas l’autorisation d’appeler ce constructeur.

Vous ne pouvez pas créer une instance d’une classe abstraite, ou ce membre a été appelé avec un mécanisme de liaison tardive.

Le constructeur, qui a été appelé par réflexion, a levé une exception.

Le type COM n’a pas été obtenu via GetTypeFromProgID ou GetTypeFromCLSID.

La création, TypedReferenceles VoidArgIteratortypes et RuntimeArgumentHandle les tableaux de ces types n’est pas prise en charge.

assemblyName n’est pas un assembly valide.

-ou-

Le Common Language Runtime (CLR) version 2.0 ou ultérieure est actuellement chargé et assemblyName a été compilé pour une version du CLR ultérieure à la version actuellement chargée. Notez que les versions .NET Framework 2.0, 3.0 et 3.5 utilisent toutes clR version 2.0.

Un assembly ou un module a été chargé deux fois avec deux preuves différentes.

-ou-

Le nom de l’assembly ou la base de code n’est pas valide.

Exemples

L’exemple suivant définit une classe nommée Person dans un assembly nommé PersonInfo. Notez que la Person classe a deux constructeurs, dont l’un est sans paramètre.

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

L’exemple suivant appelle la CreateInstance(String, String) méthode pour instancier la Person classe. Il nécessite une référence pour PersonInfo.dll être ajoutée au projet. Étant donné que la CreateInstance(String, String) méthode appelle le Person constructeur sans paramètre de classe, l’exemple affecte une valeur à sa Name propriété.

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

Toutefois, CreateInstance il est fréquemment appelé pour instancier un type qui traverse les limites de l’ordinateur ou qui n’est pas connu au moment du design. Dans ce cas, vous ne pouvez pas inclure de référence à l’assembly dans le projet et ne pouvez pas effectuer d’appels à liaison anticipée aux membres du type. Pour contourner cette limitation, l’exemple suivant utilise la méthode ainsi que la CreateInstance réflexion pour affecter une valeur à la propriété de Name l’objet Person et afficher sa valeur.

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

Remarques

Permet ObjectHandle.Unwrap de désencapsuler la valeur de retour.

assemblyName peut être l’une des options suivantes :

  • Nom simple d’un assembly, sans son chemin d’accès ou son extension de fichier. Par exemple, vous devez spécifier TypeExtensions pour un assembly dont le chemin et le nom sont .\bin\TypeExtensions.dll.

  • Nom complet d’un assembly signé, qui se compose de son nom simple, version, culture et jeton de clé publique ; par exemple, « TypeExtensions, Version=1.0.0.0, Culture=neutral, PublicKeyToken=181869f2f7435b51 ».

Pour plus d’informations sur la façon dont le Common Language Runtime identifie et charge des assemblys, consultez Comment le runtime localise les assemblys. Pour plus d’informations sur l’utilisation du fichier de configuration de l’application pour définir des emplacements d’assembly, consultez Spécification de l’emplacement d’un assembly. S’il assemblyName est trouvé, il est chargé dans le contexte par défaut.

Dans .NET Core 3.0 et versions ultérieures, les chargements d’assembly déclenchés par cette API sont affectés par la valeur actuelle de AssemblyLoadContext.CurrentContextualReflectionContext.

Note

Cette méthode peut être utilisée pour créer des types non publics si l’appelant a été accordé ReflectionPermission avec l’indicateur ReflectionPermissionFlag.RestrictedMemberAccess et si le jeu d’octroi de l’assembly qui contient les types non publics est limité au jeu d’octroi de l’appelant ou à un sous-ensemble de celui-ci. (Consultez Considérations relatives à la sécurité pour la réflexion.) Pour utiliser cette fonctionnalité, votre application doit cibler .NET Framework 3.5 ou version ultérieure.

S’applique à

CreateInstance(ActivationContext, String[])

Crée une instance du type désigné par l’objet spécifié ActivationContext et activée avec les données d’activation personnalisées spécifiées.

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstance(ActivationContext ^ activationContext, cli::array <System::String ^> ^ activationCustomData);
public static System.Runtime.Remoting.ObjectHandle CreateInstance(ActivationContext activationContext, string[] activationCustomData);
static member CreateInstance : ActivationContext * string[] -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateInstance (activationContext As ActivationContext, activationCustomData As String()) As ObjectHandle

Paramètres

activationContext
ActivationContext

Objet de contexte d’activation qui spécifie l’objet à créer.

activationCustomData
String[]

Tableau de chaînes Unicode qui contiennent des données d’activation personnalisées.

Retours

Handle qui doit être décompressé pour accéder à l’objet nouvellement créé ou null pour Nullable<T> les instances.

Remarques

Utilisez la ObjectHandle.Unwrap méthode pour annuler la valeur de retour.

Le contexte d’activation est utilisé pendant l’activation basée sur le manifeste pour configurer la stratégie de domaine et fournir un modèle de sécurité basé sur l’application. La ActivationContext classe contient un ApplicationIdentity objet qui fournit l’accès au manifeste de l’application. Pour plus d’informations, consultez la classe ApplicationSecurityManager.

Voir aussi

S’applique à

CreateInstance(Type)

Source:
Activator.cs
Source:
Activator.cs
Source:
Activator.cs
Source:
Activator.cs
Source:
Activator.cs

Crée une instance du type spécifié à l’aide du constructeur sans paramètre de ce type.

public:
 static System::Object ^ CreateInstance(Type ^ type);
public static object CreateInstance(Type type);
public static object? CreateInstance(Type type);
static member CreateInstance : Type -> obj
Public Shared Function CreateInstance (type As Type) As Object

Paramètres

type
Type

Type d’objet à créer.

Retours

Référence à l’objet nouvellement créé ou null pour Nullable<T> les instances.

Exceptions

type a la valeur null.

type n’est pas un RuntimeType.

-ou-

type est un type générique ouvert (autrement dit, la ContainsGenericParameters propriété renvoie true).

type ne peut pas être un TypeBuilder.

-ou-

La création, TypedReferenceles VoidArgIteratortypes et RuntimeArgumentHandle les tableaux de ces types n’est pas prise en charge.

-ou-

L’assembly qui contient type est un assembly dynamique qui a été créé avec Save.

Le constructeur appelé lève une exception.

L’appelant n’a pas l’autorisation d’appeler ce constructeur.

Impossible de créer une instance d’une classe abstraite, ou ce membre a été appelé avec un mécanisme de liaison tardive.

Le type COM n’a pas été obtenu via GetTypeFromProgID ou GetTypeFromCLSID.

Aucun constructeur public correspondant n’a été trouvé.

type est un objet COM, mais l’identificateur de classe utilisé pour obtenir le type n’est pas valide ou la classe identifiée n’est pas inscrite.

type n’est pas un type valide.

Exemples

L’exemple de code suivant montre comment appeler la CreateInstance(Type) méthode. Les instances de plusieurs types différents sont créées et leurs valeurs par défaut sont affichées.

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

Remarques

Le constructeur à appeler doit être accessible.

Note

Cette méthode peut être utilisée pour accéder aux types non publics si l’appelant a été accordé ReflectionPermission avec l’indicateur ReflectionPermissionFlag.RestrictedMemberAccess et si le jeu d’octroi de l’assembly qui contient les types non publics est limité au jeu d’octroi de l’appelant ou à un sous-ensemble de celui-ci. (Consultez Considérations relatives à la sécurité pour la réflexion.) Pour utiliser cette fonctionnalité, votre application doit cibler .NET Framework 3.5 ou version ultérieure.

S’applique à

CreateInstance(ActivationContext)

Crée une instance du type désigné par l’objet spécifié ActivationContext .

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstance(ActivationContext ^ activationContext);
public static System.Runtime.Remoting.ObjectHandle CreateInstance(ActivationContext activationContext);
static member CreateInstance : ActivationContext -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateInstance (activationContext As ActivationContext) As ObjectHandle

Paramètres

activationContext
ActivationContext

Objet de contexte d’activation qui spécifie l’objet à créer.

Retours

Handle qui doit être décompressé pour accéder à l’objet nouvellement créé ou null pour Nullable<T> les instances.

Remarques

Utilisez la ObjectHandle.Unwrap méthode pour annuler la valeur de retour.

Le contexte d’activation est utilisé pendant l’activation basée sur le manifeste pour configurer la stratégie de domaine et fournir un modèle de sécurité basé sur l’application. La ActivationContext classe contient un ApplicationIdentity objet qui fournit l’accès au manifeste de l’application. Pour plus d’informations, consultez la classe ApplicationSecurityManager.

Voir aussi

S’applique à

CreateInstance(AppDomain, String, String)

Crée une instance du type dont le nom est spécifié dans le domaine distant spécifié, à l’aide de l’assembly nommé et du constructeur sans paramètre.

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstance(AppDomain ^ domain, System::String ^ assemblyName, System::String ^ typeName);
public static System.Runtime.Remoting.ObjectHandle CreateInstance(AppDomain domain, string assemblyName, string typeName);
[System.Security.SecurityCritical]
public static System.Runtime.Remoting.ObjectHandle CreateInstance(AppDomain domain, string assemblyName, string typeName);
static member CreateInstance : AppDomain * string * string -> System.Runtime.Remoting.ObjectHandle
[<System.Security.SecurityCritical>]
static member CreateInstance : AppDomain * string * string -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateInstance (domain As AppDomain, assemblyName As String, typeName As String) As ObjectHandle

Paramètres

domain
AppDomain

Domaine distant où le type nommé typeName est créé.

assemblyName
String

Nom de l’assembly dans lequel le type nommé typeName est recherché. Si assemblyName c’est nullle cas, l’assembly en cours d’exécution est recherché.

typeName
String

Nom complet du type à créer une instance.

Retours

Handle qui doit être décompressé pour accéder à l’objet nouvellement créé ou null pour Nullable<T> les instances.

Attributs

Exceptions

typeName ou domain est null.

Aucun constructeur public correspondant n’a été trouvé.

typeName n’a pas été trouvé dans assemblyName.

assemblyName n’a pas été trouvé.

L’appelant n’a pas l’autorisation d’appeler ce constructeur.

Impossible de créer une instance d’un type abstrait.

-ou-

Ce membre a été appelé avec un mécanisme de liaison tardive.

Le constructeur, qui a été appelé par réflexion, a levé une exception.

Le type COM n’a pas été obtenu via GetTypeFromProgID ou GetTypeFromCLSID.

La création, TypedReferenceles VoidArgIteratortypes et RuntimeArgumentHandle les tableaux de ces types n’est pas prise en charge.

assemblyName n’est pas un assembly valide.

-ou-

Le Common Language Runtime (CLR) version 2.0 ou ultérieure est actuellement chargé et assemblyName a été compilé pour une version du CLR ultérieure à la version actuellement chargée. Notez que les versions .NET Framework 2.0, 3.0 et 3.5 utilisent toutes clR version 2.0.

Un assembly ou un module a été chargé deux fois avec deux preuves différentes.

-ou-

Le nom de l’assembly ou la base de code n’est pas valide.

Remarques

Utiliser CreateInstance lorsqu’un hôte doit exécuter du code dans un domaine d’application disposant d’autorisations de sécurité restreintes.

Permet ObjectHandle.Unwrap de désencapsuler la valeur de retour.

S’applique à

CreateInstance<T>()

Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs
Source:
Activator.RuntimeType.cs

Crée une instance du type désigné par le paramètre de type générique spécifié, à l’aide du constructeur sans paramètre.

public:
generic <typename T>
 static T CreateInstance();
public static T CreateInstance<T>();
public static T CreateInstance<T>() where T : allows ref struct;
static member CreateInstance : unit -> 'T
Public Shared Function CreateInstance(Of T) () As T

Paramètres de type

T

Type à créer.

Retours

T

Référence à l’objet nouvellement créé ou null pour Nullable<T> les instances.

Exceptions

Impossible de créer une instance d’une classe abstraite, ou le type spécifié pour T n’a pas de constructeur sans paramètre.

Remarques

La CreateInstance<T>() méthode générique est utilisée par les compilateurs pour implémenter l’instanciation des types spécifiés par les paramètres de type. Par exemple, dans la méthode générique suivante, l’implémentation d’utilisations de new T() la CreateInstance<T>() méthode générique.

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

En général, il n’existe aucune utilisation pour la méthode générique dans le code d’application, car le type doit être connu au moment de la CreateInstance<T>() compilation. Si le type est connu au moment de la compilation, la syntaxe d’instanciation normale peut être utilisée (new opérateur en C#, New en Visual Basic). Si le type n’est pas connu au moment de la compilation, vous pouvez appeler une surcharge non générique de CreateInstance.

Il n’existe pas de surcharges de la CreateInstance<T>() méthode générique qui acceptent des listes d’arguments, car les surcharges non génériques d’un CreateInstance constructeur à liaison tardive fournissent déjà une résolution de constructeur à liaison tardive.

S’applique à