Activator.CreateInstance Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

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

Surcharges

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(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(Type)	Crée une instance du type spécifié à l’aide du constructeur sans paramètre de ce type.
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(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])

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.

C#

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

Paramètres

assemblyName

String

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

typeName

String

Nom complet du type à créer une instance.

ignoreCase

Boolean

true spécifier que la recherche de 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 constructeur typeName. Si bindingAttr est égal à zéro, une recherche sensible à la casse pour les constructeurs publics est effectuée.

binder

Binder

Objet qui utilise bindingAttr et args pour rechercher et identifier le constructeur typeName. Si binder est null, 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. Si args est 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 de args aux types formels déclarés pour le constructeur typeName. Si culture est null, le CultureInfo du 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 objet 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

ObjectHandle

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

Exceptions

ArgumentNullException

typeName est null.

MissingMethodException

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

TypeLoadException

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

FileNotFoundException

assemblyName n’a pas été trouvé.

MethodAccessException

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

MemberAccessException

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

TargetInvocationException

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

InvalidComObjectException

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

NotSupportedException

La création de TypedReference, ArgIterator, Voidet RuntimeArgumentHandle types ou 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 à args a des arguments varargs.

BadImageFormatException

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.

FileLoadException

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

Utilisez ObjectHandle.Unwrap pour désencapsuler la valeur de retour.

Note

À compter de .NET Framework 2.0, cette méthode peut être utilisée pour créer des types et des membres non publics si l’appelant a reçu ReflectionPermission avec 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.

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

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.

C#

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

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 constructeur type. Si bindingAttr est égal à zéro, une recherche sensible à la casse pour les constructeurs publics est effectuée.

binder

Binder

Objet qui utilise bindingAttr et args pour rechercher et identifier le constructeur type. Si binder est null, 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. Si args est 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 de args aux types formels déclarés pour le constructeur type. Si culture est null, le CultureInfo du 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 objet 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

Object

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

Exceptions

ArgumentNullException

type est null.

ArgumentException

type n’est pas un RuntimeType.

-ou-

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

NotSupportedException

type ne peut pas être un TypeBuilder.

-ou-

La création de TypedReference, ArgIterator, Voidet RuntimeArgumentHandle types ou 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 créé avec Save.

-ou-

Le constructeur qui correspond le mieux à args a des arguments varargs.

TargetInvocationException

Le constructeur appelé lève une exception.

MethodAccessException

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

MemberAccessException

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

InvalidComObjectException

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

MissingMethodException

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

COMException

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.

TypeLoadException

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

À compter de .NET Framework 2.0, cette méthode peut être utilisée pour accéder aux types et membres non publics si l’appelant a reçu ReflectionPermission avec l’indicateur de 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.

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

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.

C#

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

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 constructeur type. Si bindingAttr est égal à zéro, une recherche sensible à la casse pour les constructeurs publics est effectuée.

binder

Binder

Objet qui utilise bindingAttr et args pour rechercher et identifier le constructeur type. Si binder est null, 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. Si args est 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 de args aux types formels déclarés pour le constructeur type. Si culture est null, le CultureInfo du thread actuel est utilisé.

Retours

Object

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

Exceptions

ArgumentNullException

type est null.

ArgumentException

type n’est pas un RuntimeType.

-ou-

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

NotSupportedException

type ne peut pas être un TypeBuilder.

-ou-

La création de TypedReference, ArgIterator, Voidet RuntimeArgumentHandle types ou tableaux de ces types n’est pas prise en charge.

-ou-

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

-ou-

Le constructeur qui correspond le mieux à args a des arguments varargs.

TargetInvocationException

Le constructeur appelé lève une exception.

MethodAccessException

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

MemberAccessException

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

InvalidComObjectException

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

MissingMethodException

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

COMException

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.

TypeLoadException

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

À compter de .NET Framework 2.0, cette méthode peut être utilisée pour accéder aux types et membres non publics si l’appelant a reçu ReflectionPermission avec l’indicateur de 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.

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

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.

C#

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

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. Si args est 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 seul objet 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

Object

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

Exceptions

ArgumentNullException

type est null.

ArgumentException

type n’est pas un RuntimeType.

-ou-

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

NotSupportedException

type ne peut pas être un TypeBuilder.

-ou-

La création de TypedReference, ArgIterator, Voidet RuntimeArgumentHandle types ou 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 créé avec Save.

-ou-

Le constructeur qui correspond le mieux à args a des arguments varargs.

TargetInvocationException

Le constructeur appelé lève une exception.

MethodAccessException

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

MemberAccessException

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

InvalidComObjectException

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

MissingMethodException

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

COMException

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.

TypeLoadException

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

À compter de .NET Framework 2.0, cette méthode peut être utilisée pour accéder aux types non publics si l’appelant a reçu ReflectionPermission avec l’indicateur de ReflectionPermissionFlag.RestrictedMemberAccess et si l’ensemble 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.

CreateInstance(String, String, Object[])

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.

C#

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

Paramètres

assemblyName

String

Nom de l’assembly dans lequel le type nommé typeName est recherché. Si assemblyName est null, 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 seul objet 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

ObjectHandle

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

Exceptions

ArgumentNullException

typeName est null.

MissingMethodException

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

TypeLoadException

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

FileNotFoundException

assemblyName n’a pas été trouvé.

MethodAccessException

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

MemberAccessException

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

InvalidComObjectException

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

NotSupportedException

La création de TypedReference, ArgIterator, Voidet RuntimeArgumentHandle types ou 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.

BadImageFormatException

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.

FileLoadException

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.

TargetInvocationException

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

Utilisez ObjectHandle.Unwrap pour désencapsuler la valeur de retour.

Note

À compter de .NET Framework 2.0, cette méthode peut être utilisée pour créer des types non publics si l’appelant a reçu ReflectionPermission avec l’indicateur de ReflectionPermissionFlag.RestrictedMemberAccess et si l’ensemble d’octroi des types non publics est limité à l’ensemble d’octrois 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.

CreateInstance(Type, Object[])

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.

C#

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

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. Si args est un tableau vide ou null, le constructeur qui ne prend aucun paramètre (le constructeur sans paramètre) est appelé.

Retours

Object

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

Exceptions

ArgumentNullException

type est null.

ArgumentException

type n’est pas un RuntimeType.

-ou-

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

NotSupportedException

type ne peut pas être un TypeBuilder.

-ou-

La création de TypedReference, ArgIterator, Voidet RuntimeArgumentHandle types ou tableaux de ces types n’est pas prise en charge.

-ou-

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

-ou-

Le constructeur qui correspond le mieux à args a des arguments varargs.

TargetInvocationException

Le constructeur appelé lève une exception.

MethodAccessException

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

Remarque : Dans .NET pour les applications du Windows Store ou la bibliothèque de classes portable , interceptez l’exception de classe de base, MemberAccessException, à la place.

MemberAccessException

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

InvalidComObjectException

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

MissingMethodException

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

Remarque : Dans .NET pour les applications du Windows Store ou la bibliothèque de classes portable , interceptez l’exception de classe de base, MissingMemberException, à la place.

COMException

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.

TypeLoadException

type n’est pas un type valide.

Exemples

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

C#

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

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

C#

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

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

À compter de .NET Framework 2.0, cette méthode peut être utilisée pour accéder aux types non publics si l’appelant a reçu ReflectionPermission avec l’indicateur de ReflectionPermissionFlag.RestrictedMemberAccess et si l’ensemble 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.

CreateInstance(Type, Boolean)

Source:

Activator.RuntimeType.cs

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

C#

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

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

Object

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

Exceptions

ArgumentNullException

type est null.

ArgumentException

type n’est pas un RuntimeType.

-ou-

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

NotSupportedException

type ne peut pas être un TypeBuilder.

-ou-

La création de TypedReference, ArgIterator, Voidet RuntimeArgumentHandle types ou tableaux de ces types n’est pas prise en charge.

-ou-

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

TargetInvocationException

Le constructeur appelé lève une exception.

MethodAccessException

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

MemberAccessException

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

InvalidComObjectException

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

MissingMethodException

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

COMException

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.

TypeLoadException

type n’est pas un type valide.

Remarques

Note

À compter de .NET Framework 2.0, cette méthode peut être utilisée pour accéder aux types et membres non publics si l’appelant a reçu ReflectionPermission avec l’indicateur de 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.

CreateInstance(String, String)

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.

C#

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

Paramètres

assemblyName

String

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

typeName

String

Nom complet du type à créer une instance.

Retours

ObjectHandle

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

Exceptions

ArgumentNullException

typeName est null.

MissingMethodException

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

TypeLoadException

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

FileNotFoundException

assemblyName n’a pas été trouvé.

MethodAccessException

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

MemberAccessException

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.

TargetInvocationException

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

InvalidComObjectException

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

NotSupportedException

La création de TypedReference, ArgIterator, Voidet RuntimeArgumentHandle types ou tableaux de ces types n’est pas prise en charge.

BadImageFormatException

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.

FileLoadException

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 classe Person a deux constructeurs, dont l’un est sans paramètre.

C#

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

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

C#

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

Toutefois, CreateInstance est fréquemment appelée 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 CreateInstance ainsi que la réflexion pour affecter une valeur à la propriété Name de l’objet Person et afficher sa valeur.

C#

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

Remarques

Utilisez ObjectHandle.Unwrap pour 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 spécifiez 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. Si assemblyName est trouvé, il est chargé dans le contexte par défaut.

Note

À compter de .NET Framework 2.0, cette méthode peut être utilisée pour créer des types non publics si l’appelant a reçu ReflectionPermission avec l’indicateur de ReflectionPermissionFlag.RestrictedMemberAccess et si l’ensemble 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.

CreateInstance(Type)

Source:

Activator.cs

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

C#

public static object? CreateInstance (Type type);

Paramètres

type

Type

Type d’objet à créer.

Retours

Object

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

Exceptions

ArgumentNullException

type est null.

ArgumentException

type n’est pas un RuntimeType.

-ou-

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

NotSupportedException

type ne peut pas être un TypeBuilder.

-ou-

La création de TypedReference, ArgIterator, Voidet RuntimeArgumentHandle types ou tableaux de ces types n’est pas prise en charge.

-ou-

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

TargetInvocationException

Le constructeur appelé lève une exception.

MethodAccessException

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

Remarque : Dans .NET pour les applications du Windows Store ou la bibliothèque de classes portable , interceptez l’exception de classe de base, MemberAccessException, à la place.

MemberAccessException

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

InvalidComObjectException

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

MissingMethodException

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

Remarque : Dans .NET pour les applications du Windows Store ou la bibliothèque de classes portable , interceptez l’exception de classe de base, MissingMemberException, à la place.

COMException

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.

TypeLoadException

type n’est pas un type valide.

Exemples

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

C#

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

Remarques

Le constructeur à appeler doit être accessible.

Note

À compter de .NET Framework 2.0, cette méthode peut être utilisée pour accéder aux types non publics si l’appelant a reçu ReflectionPermission avec l’indicateur de ReflectionPermissionFlag.RestrictedMemberAccess et si l’ensemble 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.

CreateInstance<T>()

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.

C#

public static T CreateInstance<T> ();

Paramètres de type

T

Type à créer.

Retours

T

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

Exceptions

MissingMethodException

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.

Remarque : Dans .NET pour les applications du Windows Store ou la bibliothèque de classes portable , interceptez l’exception de classe de base, MissingMemberException, à la place.

Remarques

La méthode générique CreateInstance<T>() 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 de new T() (gcnew T() en C++) utilise la méthode générique CreateInstance<T>().

C#

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

En règle générale, il n’existe aucune utilisation pour la méthode générique CreateInstance<T>() dans le code d’application, car le type doit être connu au moment de la compilation. Si le type est connu au moment de la compilation, la syntaxe d’instanciation normale peut être utilisée (opérateurnew en C#, New en Visual Basic, gcnew en C++). 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 aucune surcharge de la méthode générique CreateInstance<T>() qui accepte des listes d’arguments, car les surcharges non génériques de CreateInstance fournissent déjà une résolution de constructeur à liaison tardive.