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

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é, en utilisant l'assembly nommé et le 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é, en utilisant l'assembly nommé et le 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é, en utilisant l’assembly nommé et le 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é, en utilisant l’assembly nommé et le constructeur sans paramètre.

CreateInstance(ActivationContext, String[])

Crée une instance du type désigné par l'objet ActivationContext spécifié et activé 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 ActivationContext spécifié.

CreateInstance(AppDomain, String, String)

Crée une instance du type dont le nom est spécifié dans le domaine distant spécifié, en utilisant l’assembly nommé et le 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 http://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é, en utilisant l'assembly nommé et le 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 http://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 http://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 dans lequel le type nommé typeName est créé.

assemblyName
String

Nom de l'assembly dans lequel le type nommé typeName est recherché. Si assemblyName est null, la recherche s'effectue dans l'assembly en cours d'exécution.

typeName
String

Nom qualifié complet du type pour lequel créer une instance.

ignoreCase
Boolean

true pour spécifier que la recherche de typeName ne respecte pas la casse ; false pour spécifier que la recherche respecte la casse.

bindingAttr
BindingFlags

Combinaison de zéro ou plusieurs bits indicateurs qui affectent la recherche du constructeur typeName. Si bindingAttr a la valeur zéro, une recherche de constructeurs publics qui respecte la casse est effectuée.

binder
Binder

Objet qui utilise bindingAttr et args pour rechercher et identifier le constructeur typeName. Si binder est null, le binder par défaut est utilisé.

args
Object[]

Tableau des arguments qui correspondent en nombre, en ordre et en type aux paramètres du constructeur à appeler. Si args est un tableau vide ou null, le constructeur qui ne prend aucun paramètre (constructeur sans paramètre) est appelé.

culture
CultureInfo

Informations propres à la culture qui définissent la contrainte de args pour les types formels déclarés du constructeur typeName. Si culture est null, le CultureInfo du thread actuel est utilisé.

activationAttributes
Object[]

Tableau à un ou plusieurs attributs pouvant participer à l'activation. Il s'agit généralement d'un tableau qui contient un seul objet UrlAttribute. UrlAttribute spécifie l'URL qui est 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 est introuvable dans assemblyName.

assemblyName est introuvable.

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é via la réflexion, a levé une exception.

Le type COM n’a pas été obtenu par l’intermédiaire de GetTypeFromProgID ou de GetTypeFromCLSID.

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

- ou -

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

- ou -

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

assemblyName n’est pas un assembly valide.

- ou -

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

Un assembly ou un module a été chargé à deux reprises 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 qui dispose d’autorisations de sécurité restreintes.

Utilisez ObjectHandle.Unwrap pour 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é, en utilisant l'assembly nommé et le 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 dans lequel le type nommé typeName est créé.

assemblyName
String

Nom de l'assembly dans lequel le type nommé typeName est recherché. Si assemblyName est null, la recherche s'effectue dans l'assembly en cours d'exécution.

typeName
String

Nom qualifié complet du type pour lequel créer une instance.

ignoreCase
Boolean

true pour spécifier que la recherche de typeName ne respecte pas la casse ; false pour spécifier que la recherche respecte la casse.

bindingAttr
BindingFlags

Combinaison de zéro ou plusieurs bits indicateurs qui affectent la recherche du constructeur typeName. Si bindingAttr a la valeur zéro, une recherche de constructeurs publics qui respecte la casse est effectuée.

binder
Binder

Objet qui utilise bindingAttr et args pour rechercher et identifier le constructeur typeName. Si binder est null, le binder par défaut est utilisé.

args
Object[]

Tableau des arguments qui correspondent en nombre, en ordre et en type aux paramètres du constructeur à appeler. Si args est un tableau vide ou null, le constructeur qui ne prend aucun paramètre (constructeur sans paramètre) est appelé.

culture
CultureInfo

Informations propres à la culture qui définissent la contrainte de args pour les types formels déclarés du constructeur typeName. Si culture est null, le CultureInfo du thread actuel est utilisé.

activationAttributes
Object[]

Tableau à un ou plusieurs attributs pouvant participer à l'activation. Il s'agit, en général, d'un tableau contenant un seul objet UrlAttribute qui spécifie l'URL nécessaire pour activer un objet distant.

Ce paramètre est lié aux objets activés par le client. L'activation des clients est une technologie héritée qui est conservée pour la compatibilité descendante, mais elle n'est pas recommandée pour un nouveau développement. Les applications distribuées doivent à la place 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 est introuvable dans assemblyName.

assemblyName est introuvable.

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é via la réflexion, a levé une exception.

Le type COM n’a pas été obtenu par l’intermédiaire de GetTypeFromProgID ou de GetTypeFromCLSID.

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

- ou -

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

- ou -

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

assemblyName n’est pas un assembly valide.

- ou -

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

Un assembly ou un module a été chargé à deux reprises 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 qui dispose d’autorisations de sécurité restreintes.

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

S’applique à

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.

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstance(System::String ^ assemblyName, System::String ^ typeName, bool ignoreCase, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, cli::array <System::Object ^> ^ args, System::Globalization::CultureInfo ^ culture, cli::array <System::Object ^> ^ activationAttributes);
public static System.Runtime.Remoting.ObjectHandle? CreateInstance (string assemblyName, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, object?[]? args, System.Globalization.CultureInfo? culture, object?[]? activationAttributes);
public static System.Runtime.Remoting.ObjectHandle CreateInstance (string assemblyName, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes);
static member CreateInstance : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateInstance (assemblyName As String, typeName As String, ignoreCase As Boolean, bindingAttr As BindingFlags, binder As Binder, args As Object(), culture As CultureInfo, activationAttributes As Object()) As ObjectHandle

Paramètres

assemblyName
String

Nom de l'assembly dans lequel le type nommé typeName est recherché. Si assemblyName est null, la recherche s'effectue dans l'assembly en cours d'exécution.

typeName
String

Nom qualifié complet du type pour lequel créer une instance.

ignoreCase
Boolean

true pour spécifier que la recherche de typeName ne respecte pas la casse ; false pour spécifier que la recherche respecte la casse.

bindingAttr
BindingFlags

Combinaison de zéro ou plusieurs bits indicateurs qui affectent la recherche du constructeur typeName. Si bindingAttr a la valeur zéro, une recherche de constructeurs publics qui respecte la casse est effectuée.

binder
Binder

Objet qui utilise bindingAttr et args pour rechercher et identifier le constructeur typeName. Si binder est null, le binder par défaut est utilisé.

args
Object[]

Tableau des arguments qui correspondent en nombre, en ordre et en type aux paramètres du constructeur à appeler. Si args est un tableau vide ou null, le constructeur qui ne prend aucun paramètre (constructeur sans paramètre) est appelé.

culture
CultureInfo

Informations propres à la culture qui définissent la contrainte de args pour les types formels déclarés du constructeur typeName. Si culture est null, le CultureInfo du thread actuel est utilisé.

activationAttributes
Object[]

Tableau à un ou plusieurs attributs pouvant participer à l'activation. Il s'agit, en général, d'un tableau contenant un seul objet UrlAttribute qui spécifie l'URL nécessaire pour activer un objet distant.

Ce paramètre est lié aux objets activés par le client. L'activation des clients est une technologie héritée qui est conservée pour la compatibilité descendante, mais elle n'est pas recommandée pour un nouveau développement. Les applications distribuées doivent à la place utiliser Windows Communication Foundation.

Retours

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

Exceptions

typeName a la valeur null.

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

typename est introuvable dans assemblyName.

assemblyName est introuvable.

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é via la réflexion, a levé une exception.

Le type COM n’a pas été obtenu par l’intermédiaire de GetTypeFromProgID ou de GetTypeFromCLSID.

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

- ou -

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

- ou -

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

assemblyName n’est pas un assembly valide.

- ou -

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

Un assembly ou un module a été chargé à deux reprises 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.

Notes

À 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 l’indicateur ReflectionPermissionFlag.RestrictedMemberAccess et si le jeu d’octrois de l’assembly qui contient les types et membres 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.

S’applique à

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.

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 de zéro ou plusieurs bits indicateurs qui affectent la recherche du constructeur type. Si bindingAttr a la valeur zéro, une recherche de constructeurs publics qui respecte la casse est effectuée.

binder
Binder

Objet qui utilise bindingAttr et args pour rechercher et identifier le constructeur type. Si binder est null, le binder par défaut est utilisé.

args
Object[]

Tableau des arguments qui correspondent en nombre, en ordre et en type aux paramètres du constructeur à appeler. Si args est un tableau vide ou null, le constructeur qui ne prend aucun paramètre (constructeur sans paramètre) est appelé.

culture
CultureInfo

Informations propres à la culture qui définissent la contrainte de args pour les types formels déclarés du constructeur type. Si culture est null, le CultureInfo du thread actuel est utilisé.

activationAttributes
Object[]

Tableau à un ou plusieurs attributs pouvant participer à l'activation. Il s'agit, en général, d'un tableau contenant un seul objet UrlAttribute qui spécifie l'URL nécessaire pour activer un objet distant.

Ce paramètre est lié aux objets activés par le client. L'activation des clients est une technologie héritée qui est conservée pour la compatibilité descendante, mais elle n'est pas recommandée pour un nouveau développement. Les applications distribuées doivent à la place 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 propriété ContainsGenericParameters retourne true).

type ne peut pas être TypeBuilder.

- ou -

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

- ou -

activationAttributes n’est pas un tableau vide, et le type à créer 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 à args a des arguments varargs.

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 par l’intermédiaire de GetTypeFromProgID ou de 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 du classeur et des attributs de liaison spécifiés.

Notes

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

S’applique à

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.

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 de zéro ou plusieurs bits indicateurs qui affectent la recherche du constructeur type. Si bindingAttr a la valeur zéro, une recherche de constructeurs publics qui respecte la casse est effectuée.

binder
Binder

Objet qui utilise bindingAttr et args pour rechercher et identifier le constructeur type. Si binder est null, le binder par défaut est utilisé.

args
Object[]

Tableau des arguments qui correspondent en nombre, en ordre et en type aux paramètres du constructeur à appeler. Si args est un tableau vide ou null, le constructeur qui ne prend aucun paramètre (constructeur sans paramètre) est appelé.

culture
CultureInfo

Informations propres à la culture qui définissent la contrainte de args pour les types formels déclarés du constructeur type. Si culture est null, le CultureInfo du 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 propriété ContainsGenericParameters retourne true).

type ne peut pas être TypeBuilder.

- ou -

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

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 par l’intermédiaire de GetTypeFromProgID ou de 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 du classeur et des attributs de liaison spécifiés.

Notes

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

S’applique à

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.

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 des arguments qui correspondent en nombre, en ordre et en type aux paramètres du constructeur à appeler. Si args est un tableau vide ou null, le constructeur qui ne prend aucun paramètre (constructeur sans paramètre) est appelé.

activationAttributes
Object[]

Tableau à un ou plusieurs attributs pouvant participer à l'activation. Il s'agit, en général, d'un tableau contenant un seul objet UrlAttribute qui spécifie l'URL nécessaire pour activer un objet distant.

Ce paramètre est lié aux objets activés par le client. L'activation des clients est une technologie héritée qui est conservée pour la compatibilité descendante, mais elle n'est pas recommandée pour un nouveau développement. Les applications distribuées doivent à la place 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 propriété ContainsGenericParameters retourne true).

type ne peut pas être TypeBuilder.

- ou -

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

- ou -

activationAttributes n’est pas un tableau vide, et le type à créer 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 à args a des arguments varargs.

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 par l’intermédiaire de GetTypeFromProgID ou de 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.

Notes

À 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 l’indicateur ReflectionPermissionFlag.RestrictedMemberAccess et si le jeu d’octrois de l’assembly qui contient les 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.

S’applique à

CreateInstance(String, String, Object[])

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

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstance(System::String ^ assemblyName, System::String ^ typeName, cli::array <System::Object ^> ^ activationAttributes);
public static System.Runtime.Remoting.ObjectHandle? CreateInstance (string assemblyName, string typeName, object?[]? activationAttributes);
public static System.Runtime.Remoting.ObjectHandle CreateInstance (string assemblyName, string typeName, object[] activationAttributes);
static member CreateInstance : string * string * obj[] -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateInstance (assemblyName As String, typeName As String, activationAttributes As Object()) As ObjectHandle

Paramètres

assemblyName
String

Nom de l'assembly dans lequel le type nommé typeName est recherché. Si assemblyName est null, la recherche s'effectue dans l'assembly en cours d'exécution.

typeName
String

Nom qualifié complet du type pour lequel créer une instance.

activationAttributes
Object[]

Tableau à un ou plusieurs attributs pouvant participer à l'activation. Il s'agit, en général, d'un tableau contenant un seul objet UrlAttribute qui spécifie l'URL nécessaire pour activer un objet distant.

Ce paramètre est lié aux objets activés par le client. L'activation des clients est une technologie héritée qui est conservée pour la compatibilité descendante, mais elle n'est pas recommandée pour un nouveau développement. Les applications distribuées doivent à la place 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.

Exceptions

typeName a la valeur null.

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

typename est introuvable dans assemblyName.

assemblyName est introuvable.

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 par l’intermédiaire de GetTypeFromProgID ou de GetTypeFromCLSID.

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

- ou -

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

- ou -

activationAttributes n’est pas un tableau UrlAttribute

.

assemblyName n’est pas un assembly valide.

- ou -

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

Un assembly ou un module a été chargé à deux reprises 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

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

Notes

À 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 l’indicateur ReflectionPermissionFlag.RestrictedMemberAccess et si le jeu d’octrois des types non publics est limité au jeu 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.

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 http://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 http://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 http://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 est null, la recherche s'effectue dans l'assembly en cours d'exécution.

typeName
String

Nom qualifié complet du type pour lequel créer une instance.

ignoreCase
Boolean

true pour spécifier que la recherche de typeName ne respecte pas la casse ; false pour spécifier que la recherche respecte la casse.

bindingAttr
BindingFlags

Combinaison de zéro ou plusieurs bits indicateurs qui affectent la recherche du constructeur typeName. Si bindingAttr a la valeur zéro, une recherche de constructeurs publics qui respecte la casse est effectuée.

binder
Binder

Objet qui utilise bindingAttr et args pour rechercher et identifier le constructeur typeName. Si binder est null, le binder par défaut est utilisé.

args
Object[]

Tableau des arguments qui correspondent en nombre, en ordre et en type aux paramètres du constructeur à appeler. Si args est un tableau vide ou null, le constructeur qui ne prend aucun paramètre (constructeur sans paramètre) est appelé.

culture
CultureInfo

Informations propres à la culture qui définissent la contrainte de args pour les types formels déclarés du constructeur typeName. Si culture est null, le CultureInfo du thread actuel est utilisé.

activationAttributes
Object[]

Tableau à un ou plusieurs attributs pouvant participer à l'activation. Il s'agit, en général, d'un tableau contenant un seul objet UrlAttribute qui spécifie l'URL nécessaire pour activer un objet distant.

Ce paramètre est lié aux objets activés par le client. L'activation des clients est une technologie héritée qui est conservée pour la compatibilité descendante, mais elle n'est pas recommandée pour un nouveau développement. Les applications distribuées doivent à la place 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 est introuvable dans assemblyName.

assemblyName est introuvable.

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é via la réflexion, a levé une exception.

Le type COM n’a pas été obtenu par l’intermédiaire de GetTypeFromProgID ou de GetTypeFromCLSID.

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

- ou -

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

- ou -

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

assemblyName n’est pas un assembly valide.

- ou -

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

Un assembly ou un module a été chargé à deux reprises 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.

Notes

À 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 l’indicateur ReflectionPermissionFlag.RestrictedMemberAccess et si le jeu d’octrois de l’assembly qui contient les types et membres 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.

S’applique à

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.

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 des arguments qui correspondent en nombre, en ordre et en type aux paramètres du constructeur à appeler. Si args est un tableau vide ou null, le constructeur qui ne prend aucun paramètre (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 propriété ContainsGenericParameters retourne true).

type ne peut pas être TypeBuilder.

- ou -

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

Le constructeur appelé lève une exception.

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.

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 par l’intermédiaire de GetTypeFromProgID ou de GetTypeFromCLSID.

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.

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 quatorziè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 déchiqueté dont les éléments sont des arguments à passer à un String constructeur. L’exemple passe 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.

Notes

À 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 l’indicateur ReflectionPermissionFlag.RestrictedMemberAccess et si le jeu d’octrois de l’assembly qui contient les types non publics est limité au jeu 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.

S’applique à

CreateInstance(Type, Boolean)

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 public sans paramètre 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 propriété ContainsGenericParameters retourne true).

type ne peut pas être TypeBuilder.

- ou -

La création de types TypedReference, ArgIterator, Void et RuntimeArgumentHandle, ou de 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 par l’intermédiaire de GetTypeFromProgID ou de 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

Notes

À 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 l’indicateur ReflectionPermissionFlag.RestrictedMemberAccess et si le jeu d’octrois de l’assembly qui contient les types et membres 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.

S’applique à

CreateInstance(String, String)

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

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstance(System::String ^ assemblyName, System::String ^ typeName);
public static System.Runtime.Remoting.ObjectHandle? CreateInstance (string assemblyName, string typeName);
public static System.Runtime.Remoting.ObjectHandle CreateInstance (string assemblyName, string typeName);
static member CreateInstance : string * string -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateInstance (assemblyName As String, typeName As String) As ObjectHandle

Paramètres

assemblyName
String

Nom de l'assembly dans lequel le type nommé typeName est recherché. Si assemblyName est null, la recherche s'effectue dans l'assembly en cours d'exécution.

typeName
String

Nom qualifié complet du type pour lequel 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.

Exceptions

typeName a la valeur null.

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

typename est introuvable dans assemblyName.

assemblyName est introuvable.

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é via la réflexion, a levé une exception.

Le type COM n’a pas été obtenu par l’intermédiaire de GetTypeFromProgID ou de GetTypeFromCLSID.

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

assemblyName n’est pas un assembly valide.

- ou -

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

Un assembly ou un module a été chargé à deux reprises 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 . Elle nécessite l’ajout d’une référence à PersonInfo.dll 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 est fréquemment appelé pour instancier un type qui dépasse les limites de la machine ou qui n’est pas connu au moment du design. Dans ce cas, vous ne pouvez pas inclure une référence à l’assembly dans le projet et vous ne pouvez pas effectuer d’appels liés tôt aux membres du type. Pour contourner cette limitation, l’exemple suivant utilise la méthode avec 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

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

assemblyName il peut s’agir de l’un des éléments suivants :

  • 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, de sa version, de sa culture et de son 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 les assemblys, consultez Comment le runtime localise les assemblys. Pour plus d’informations sur l’utilisation du fichier de configuration d’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.

Notes

À 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 l’indicateur ReflectionPermissionFlag.RestrictedMemberAccess et si le jeu d’octrois de l’assembly qui contient les 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.

S’applique à

CreateInstance(ActivationContext, String[])

Crée une instance du type désigné par l'objet ActivationContext spécifié et activé 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 les 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 désencapsuler la valeur de retour.

Le contexte d’activation est utilisé lors de 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)

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 propriété ContainsGenericParameters retourne true).

type ne peut pas être TypeBuilder.

- ou -

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

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.

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 par l’intermédiaire de GetTypeFromProgID ou de GetTypeFromCLSID.

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.

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 . Des instances de plusieurs types différents sont créées et leurs valeurs par défaut sont affichées.

using namespace System;

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

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

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

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

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

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

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

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

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

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

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

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

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


// This program will display output similar to the following:
//
// Creating instance of: System.EventArgs
// Creating instance of: System.Random
// Creating instance of: System.Exception
// Creating instance of: System.Object
// Creating instance of: System.Version
//
// Objects and their default values:
//
// Type:     System.EventArgs
// Value:    System.EventArgs
// HashCode: 46104728
//
// Type:     System.Random
// Value:    System.Random
// HashCode: 12289376
//
// Type:     System.Exception
// Value:    System.Exception: Exception of type 'System.Exception' was thrown.
// HashCode: 55530882
//
// Type:     System.Object
// Value:    System.Object
// HashCode: 30015890
//
// Type:     System.Version
// Value:    0.0
// HashCode: 1048575
Class DynamicInstanceList
    Private Shared instanceSpec As String = "System.EventArgs;System.Random;" + _
        "System.Exception;System.Object;System.Version"

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

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

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

Remarques

Le constructeur à appeler doit être accessible.

Notes

À 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 l’indicateur ReflectionPermissionFlag.RestrictedMemberAccess et si le jeu d’octrois de l’assembly qui contient les types non publics est limité au jeu 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.

S’applique à

CreateInstance(ActivationContext)

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

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 désencapsuler la valeur de retour.

Le contexte d’activation est utilisé lors de 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é, en utilisant l’assembly nommé et le 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 dans lequel le type nommé typeName est créé.

assemblyName
String

Nom de l'assembly dans lequel le type nommé typeName est recherché. Si assemblyName est null, la recherche s'effectue dans l'assembly en cours d'exécution.

typeName
String

Nom qualifié complet du type pour lequel 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 est introuvable dans assemblyName.

assemblyName est introuvable.

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é via la réflexion, a levé une exception.

Le type COM n’a pas été obtenu par l’intermédiaire de GetTypeFromProgID ou de GetTypeFromCLSID.

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

assemblyName n’est pas un assembly valide.

- ou -

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

Un assembly ou un module a été chargé à deux reprises 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.

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

S’applique à

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.

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

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 de 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 la classe de base, MissingMemberException, à la place.

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

public:
    generic <typename T> where T:gcnew()
    static T Bar()
    {
        return gcnew T();
    }
public static T Factory<T>() where T : new()
{
    return new T();
}
let factory<'T when 'T : (new: unit -> 'T)> =
    new 'T()
Public Shared Function Factory(Of T As New)() As T
    Return New T()
End Function

En général, la méthode générique n’est pas utilisée dans le CreateInstance<T>() 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 (new opérateur 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’y a aucune surcharge de la CreateInstance<T>() méthode générique qui prend des listes d’arguments, car les surcharges non génériques de fournissent déjà une CreateInstance résolution de constructeur lié tardivement.

S’applique à