AppDomain.CreateInstance Méthode

Définition

Crée une instance d'un type spécifié défini dans un assembly déterminé.

Surcharges

CreateInstance(String, String)

Crée une instance du type spécifié défini dans l'assembly déterminé.

CreateInstance(String, String, Object[])

Crée une instance du type spécifié défini dans l'assembly déterminé. Un paramètre spécifie un tableau d'attributs d'activation.

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

Crée une instance du type spécifié défini dans l'assembly déterminé. Les paramètres spécifient un binder, des indicateurs de liaisons, des arguments de constructeur, les informations spécifiques à la culture utilisées pour interpréter les arguments et des attributs d'activation facultatifs.

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

Crée une instance du type spécifié défini dans l'assembly déterminé. Les paramètres spécifient un binder, des indicateurs de liaisons, des arguments de constructeur, des informations propres à la culture utilisées pour interpréter les arguments, des attributs d’activation et l’autorisation de créer le type.

CreateInstance(String, String)

Crée une instance du type spécifié défini dans l'assembly déterminé.

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

Paramètres

assemblyName
String

Nom complet de l'assembly. Consultez FullName.

typeName
String

Nom qualifié complet du type demandé, y compris l'espace de noms mais pas l'assembly, tel qu'il est retourné par la propriété FullName.

Retours

Objet qui est un wrapper de la nouvelle instance spécifiée par typeName. La valeur de retour doit être désencapsulée pour accéder à l'objet réel.

Implémente

Exceptions

L’opération est tentée sur un domaine d’application non chargé.

assemblyName ou typeName est null.

assemblyName n’est pas un assembly valide pour le runtime actuellement chargé.

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

assemblyName est introuvable.

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

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

typename est introuvable dans assemblyName.

L’instance est null.

Remarques

Cette méthode appelle le constructeur sans paramètre pour typeName.

Consultez AssemblyName pour connaître le format de assemblyName.

Une tentative d’appel CreateInstance sur un domaine d’application cible qui n’est pas le domaine d’application actuel entraîne un chargement réussi de l’assembly dans le domaine d’application cible. Étant donné qu’un Assembly n’est pas MarshalByRefObject, lorsque cette méthode tente de retourner l’assembly Assembly chargé au domaine d’application actuel, le Common Language Runtime tente de charger l’assembly dans le domaine d’application actuel et le chargement peut échouer. L’assembly chargé dans le domaine d’application actuel peut être différent de l’assembly qui a été chargé en premier si les paramètres de chemin d’accès pour les deux domaines d’application sont différents.

Voir aussi

S’applique à

CreateInstance(String, String, Object[])

Crée une instance du type spécifié défini dans l'assembly déterminé. Un paramètre spécifie un tableau d'attributs d'activation.

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

Paramètres

assemblyName
String

Nom complet de l'assembly. Consultez FullName.

typeName
String

Nom qualifié complet du type demandé, y compris l'espace de noms mais pas l'assembly, tel qu'il est retourné par la propriété FullName.

activationAttributes
Object[]

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

Ce paramètre concerne les objets activés par le client. L’activation par le client est une technologie héritée qui a été conservée pour la compatibilité descendante. Toutefois, elle n’est pas recommandée pour les nouveaux développements. Les applications distribuées doivent à la place utiliser Windows Communication Foundation.

Retours

Objet qui est un wrapper de la nouvelle instance spécifiée par typeName. La valeur de retour doit être désencapsulée pour accéder à l'objet réel.

Implémente

Exceptions

L’opération est tentée sur un domaine d’application non chargé.

assemblyName ou typeName est null.

assemblyName n’est pas un assembly valide pour le runtime actuellement chargé.

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

assemblyName est introuvable.

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

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

L’appelant ne peut pas fournir d’attributs d’activation pour un objet qui n’hérite pas de MarshalByRefObject.

typename est introuvable dans assemblyName.

L’instance est null.

Remarques

Cette méthode appelle le constructeur sans paramètre pour typeName.

Consultez AssemblyName pour connaître le format de assemblyName.

Une tentative d’appel CreateInstance sur un domaine d’application cible qui n’est pas le domaine d’application actuel entraîne un chargement réussi de l’assembly dans le domaine d’application cible. Étant donné qu’un Assembly n’est pas MarshalByRefObject, lorsque cette méthode tente de retourner l’assembly Assembly chargé au domaine d’application actuel, le Common Language Runtime tente de charger l’assembly dans le domaine d’application actuel et le chargement peut échouer. L’assembly chargé dans le domaine d’application actuel peut être différent de l’assembly qui a été chargé en premier si les paramètres de chemin d’accès pour les deux domaines d’application sont différents.

Voir aussi

S’applique à

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

Crée une instance du type spécifié défini dans l'assembly déterminé. Les paramètres spécifient un binder, des indicateurs de liaisons, des arguments de constructeur, les informations spécifiques à la culture utilisées pour interpréter les arguments et des attributs d'activation facultatifs.

public:
 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 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 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);
member this.CreateInstance : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> System.Runtime.Remoting.ObjectHandle
Public 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 complet de l'assembly. Consultez FullName.

typeName
String

Nom qualifié complet du type demandé, y compris l'espace de noms mais pas l'assembly, tel qu'il est retourné par la propriété FullName.

ignoreCase
Boolean

Valeur bouléenne spécifiant s'il convient d'effectuer ou non une recherche qui 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 active la liaison, la contrainte de types d'arguments, l'appel des membres et la récupération d'objets MemberInfo par le biais de la réflexion. Si binder est null, le binder par défaut est utilisé.

args
Object[]

Arguments à passer au constructeur. Ce tableau d'arguments doit posséder les mêmes nombre, ordre et type que les paramètres du constructeur à appeler. Si vous souhaitez utiliser le constructeur sans paramètre, args doit être un tableau vide ou Null.

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. En général, 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

Objet qui est un wrapper de la nouvelle instance spécifiée par typeName. La valeur de retour doit être désencapsulée pour accéder à l'objet réel.

Exceptions

L’opération est tentée sur un domaine d’application non chargé.

assemblyName ou typeName est null.

assemblyName n’est pas un assembly valide pour le runtime actuellement chargé.

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

assemblyName est introuvable.

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

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

L’appelant ne peut pas fournir d’attributs d’activation pour un objet qui n’hérite pas de MarshalByRefObject.

typename est introuvable dans assemblyName.

L’instance est null.

Remarques

Consultez AssemblyName pour connaître le format de assemblyName.

Une tentative d’appel CreateInstance sur un domaine d’application cible qui n’est pas le domaine d’application actuel entraîne un chargement réussi de l’assembly dans le domaine d’application cible. Étant donné qu’un Assembly n’est pas MarshalByRefObject, lorsque cette méthode tente de retourner l’assembly Assembly chargé au domaine d’application actuel, le Common Language Runtime tente de charger l’assembly dans le domaine d’application actuel et le chargement peut échouer. L’assembly chargé dans le domaine d’application actuel peut être différent de l’assembly qui a été chargé en premier si les paramètres de chemin d’accès pour les deux domaines d’application sont différents.

Voir aussi

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 spécifié défini dans l'assembly déterminé. Les paramètres spécifient un binder, des indicateurs de liaisons, des arguments de constructeur, des informations propres à la culture utilisées pour interpréter les arguments, des attributs d’activation et l’autorisation de créer le type.

public:
 virtual 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 ^ securityAttributes);
public 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 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.")]
public 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 securityAttributes);
abstract member CreateInstance : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> System.Runtime.Remoting.ObjectHandle
override this.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.")>]
abstract member CreateInstance : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> System.Runtime.Remoting.ObjectHandle
override this.CreateInstance : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> System.Runtime.Remoting.ObjectHandle
Public 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(), securityAttributes As Evidence) As ObjectHandle

Paramètres

assemblyName
String

Nom complet de l'assembly. Consultez FullName.

typeName
String

Nom qualifié complet du type demandé, y compris l'espace de noms mais pas l'assembly, tel qu'il est retourné par la propriété FullName.

ignoreCase
Boolean

Valeur bouléenne spécifiant s'il convient d'effectuer ou non une recherche qui 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 active la liaison, la contrainte de types d'arguments, l'appel des membres et la récupération d'objets MemberInfo par le biais de la réflexion. Si binder est null, le binder par défaut est utilisé.

args
Object[]

Arguments à passer au constructeur. Ce tableau d'arguments doit posséder les mêmes nombre, ordre et type que les paramètres du constructeur à appeler. Si vous souhaitez utiliser le constructeur sans paramètre, args doit être un tableau vide ou Null.

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. En général, tableau contenant un seul objet UrlAttribute qui spécifie l'URL nécessaire pour activer un objet distant.

Ce paramètre concerne les objets activés par le client. L’activation par le client est une technologie héritée qui a été conservée pour la compatibilité descendante. Toutefois, elle n’est pas recommandée pour les nouveaux développements. Les applications distribuées doivent à la place utiliser Windows Communication Foundation.

securityAttributes
Evidence

Informations utilisées pour autoriser la création de typeName.

Retours

Objet qui est un wrapper de la nouvelle instance spécifiée par typeName. La valeur de retour doit être désencapsulée pour accéder à l'objet réel.

Implémente

Attributs

Exceptions

L’opération est tentée sur un domaine d’application non chargé.

assemblyName ou typeName est null.

assemblyName n’est pas un assembly valide pour le runtime actuellement chargé.

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

assemblyName est introuvable.

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

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

L’appelant ne peut pas fournir d’attributs d’activation pour un objet qui n’hérite pas de MarshalByRefObject.

- ou -

securityAttributes n’est pas un null. Lorsque la stratégie CAS héritée n'est pas activée, securityAttributes doit être null.

typename est introuvable dans assemblyName.

L’instance est null.

Remarques

Consultez AssemblyName pour le format de assemblyName.

Une tentative d’appel CreateInstance sur un domaine d’application cible qui n’est pas le domaine d’application actuel entraîne un chargement réussi de l’assembly dans le domaine d’application cible. Étant donné qu’un Assembly n’est pas MarshalByRefObject, lorsque cette méthode tente de renvoyer l’assembly Assembly pour l’assembly chargé au domaine d’application actuel, le Common Language Runtime tente de charger l’assembly dans le domaine d’application actuel et la charge peut échouer. L’assembly chargé dans le domaine d’application actuel peut être différent de l’assembly qui a été chargé en premier si les paramètres de chemin d’accès des deux domaines d’application sont différents.

Voir aussi

S’applique à