Lire en anglais

Partager via


Activator.CreateInstanceFrom Méthode

Définition

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

Surcharges

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

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

CreateInstanceFrom(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 du fichier d’assembly nommé et du constructeur qui correspond le mieux aux paramètres spécifiés.

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

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

CreateInstanceFrom(String, String, Object[])

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

CreateInstanceFrom(AppDomain, String, String)

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

CreateInstanceFrom(String, String)

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

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

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

CreateInstanceFrom(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 CreateInstanceFrom 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é, à l’aide du fichier d’assembly nommé et du constructeur qui correspond le mieux aux paramètres spécifiés.

public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (AppDomain domain, string assemblyFile, 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 CreateInstanceFrom 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 CreateInstanceFrom (AppDomain domain, string assemblyFile, 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);

Paramètres

domain
AppDomain

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

assemblyFile
String

Nom d’un fichier qui contient un assembly où le type nommé typeName est recherché.

typeName
String

Nom du type à créer une instance de.

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.

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

Attributs

Exceptions

domain ou typeName est null.

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

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

assemblyFile n’a pas été trouvé.

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

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

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

L’appelant a la FileIOPermissionrequise.

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

assemblyFile n’est pas un assembly valide.

-ou-

Le Common Language Runtime (CLR) version 2.0 ou ultérieure est actuellement chargé et assemblyFile 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.

Remarques

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

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

Pour plus d’informations sur les autres exceptions pouvant être levées par des méthodes appelées, consultez la section Exceptions des méthodes Assembly.LoadFrom et CreateInstance.

S’applique à

.NET Framework 4.8.1 et autres versions
Produit Versions (Obsolète)
.NET Framework 2.0, 3.0, 3.5 (4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1)

CreateInstanceFrom(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 CreateInstanceFrom 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 du fichier d’assembly nommé et du constructeur qui correspond le mieux aux paramètres spécifiés.

public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (string assemblyFile, 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 CreateInstanceFrom which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (string assemblyFile, 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);

Paramètres

assemblyFile
String

Nom d’un fichier qui contient un assembly où le type nommé typeName est recherché.

typeName
String

Nom du type à créer une instance de.

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.

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

Attributs

Exceptions

typeName est null.

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

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

assemblyFile n’a pas été trouvé.

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

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

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

L’appelant n’a pas la FileIOPermissionrequise.

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

assemblyFile n’est pas un assembly valide.

-ou-

Le Common Language Runtime (CLR) version 2.0 ou ultérieure est actuellement chargé et assemblyFile 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.

Remarques

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

Pour plus d’informations sur les autres exceptions pouvant être levées par des méthodes appelées, consultez la section Exceptions des méthodes Assembly.LoadFrom et CreateInstance.

S’applique à

.NET Framework 4.8.1 et autres versions
Produit Versions (Obsolète)
.NET Framework 1.1, 2.0, 3.0, 3.5 (4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1)

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

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

[System.Security.SecurityCritical]
public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (AppDomain domain, string assemblyFile, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes);

Paramètres

domain
AppDomain

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

assemblyFile
String

Nom d’un fichier qui contient un assembly où le type nommé typeName est recherché.

typeName
String

Nom du type à créer une instance de.

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

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

Attributs

Exceptions

domain ou typeName est null.

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

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

assemblyFile n’a pas été trouvé.

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

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

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

L’appelant a la FileIOPermissionrequise.

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

assemblyFile n’est pas un assembly valide.

-ou-

assemblyFile a été compilée pour une version du Common Language Runtime qui est ultérieure à la version actuellement chargée.

Remarques

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

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

Pour plus d’informations sur les autres exceptions pouvant être levées par des méthodes appelées, consultez les sections Exceptions des méthodes Assembly.LoadFrom et CreateInstance.

S’applique à

.NET Framework 4.8.1 et autres versions
Produit Versions
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

CreateInstanceFrom(String, String, Object[])

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

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

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

Paramètres

assemblyFile
String

Nom d’un fichier qui contient un assembly où le type nommé typeName est recherché.

typeName
String

Nom du type à créer une instance de.

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

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

Exceptions

typeName est null.

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

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

assemblyFile n’a pas été trouvé.

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

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

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

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

L’appelant a la FileIOPermissionrequise.

assemblyFile n’est pas un assembly valide.

-ou-

Le Common Language Runtime (CLR) version 2.0 ou ultérieure est actuellement chargé et assemblyFile 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.

Remarques

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

Pour plus d’informations sur les autres exceptions pouvant être levées par des méthodes appelées, consultez la section Exceptions des méthodes Assembly.LoadFrom et CreateInstance.

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

CreateInstanceFrom(AppDomain, String, String)

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

public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (AppDomain domain, string assemblyFile, string typeName);
[System.Security.SecurityCritical]
public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (AppDomain domain, string assemblyFile, string typeName);

Paramètres

domain
AppDomain

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

assemblyFile
String

Nom d’un fichier qui contient un assembly où le type nommé typeName est recherché.

typeName
String

Nom du type à créer une instance de.

Retours

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

Attributs

Exceptions

domain ou typeName est null.

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

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

assemblyFile n’a pas été trouvé.

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

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

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

L’appelant a la FileIOPermissionrequise.

assemblyFile n’est pas un assembly valide.

-ou-

Le Common Language Runtime (CLR) version 2.0 ou ultérieure est actuellement chargé et assemblyFile 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.

Remarques

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

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

Pour plus d’informations sur les autres exceptions pouvant être levées par des méthodes appelées, consultez la section Exceptions des méthodes Assembly.LoadFrom et CreateInstance.

S’applique à

.NET Framework 4.8.1 et autres versions
Produit Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

CreateInstanceFrom(String, String)

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

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

public static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom (string assemblyFile, string typeName);
public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (string assemblyFile, string typeName);

Paramètres

assemblyFile
String

Nom d’un fichier qui contient un assembly où le type nommé typeName est recherché.

typeName
String

Nom du type à créer une instance de.

Retours

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

Exceptions

typeName est null.

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

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

assemblyFile n’a pas été trouvé.

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

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

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

L’appelant a la FileIOPermissionrequise.

assemblyFile n’est pas un assembly valide.

-ou-

Le Common Language Runtime (CLR) version 2.0 ou ultérieure est actuellement chargé et assemblyFile 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.

Exemples

L’exemple de code suivant montre comment appeler la méthode CreateInstanceFrom. Cet exemple de code fait partie d’un exemple plus large fourni pour la classe Activator.

// Create an instance of the SomeType class that is defined in this
// assembly.
System.Runtime.Remoting.ObjectHandle oh =
    Activator.CreateInstanceFrom(Assembly.GetEntryAssembly().CodeBase,
                                 typeof(SomeType).FullName);

// Call an instance method defined by the SomeType type using this object.
SomeType st = (SomeType) oh.Unwrap();

st.DoSomething(5);

Remarques

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

Pour plus d’informations sur les autres exceptions pouvant être levées par des méthodes appelées, consultez la section Exceptions des méthodes Assembly.LoadFrom et CreateInstance.

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

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

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

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

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

Paramètres

assemblyFile
String

Nom d’un fichier qui contient un assembly où le type nommé typeName est recherché.

typeName
String

Nom du type à créer une instance de.

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

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

Exceptions

typeName est null.

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

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

assemblyFile n’a pas été trouvé.

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

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

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

L’appelant n’a pas la FileIOPermissionrequise.

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

assemblyFile n’est pas un assembly valide.

-ou-

Le Common Language Runtime (CLR) version 2.0 ou ultérieure est actuellement chargé et assemblyFile 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.

Remarques

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

Pour plus d’informations sur les autres exceptions pouvant être levées par des méthodes appelées, consultez la section Exceptions des méthodes Assembly.LoadFrom et CreateInstance.

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1