Activator.CreateInstanceFrom Méthode
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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) |
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, System::String ^ assemblyFile, 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 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);
static member CreateInstanceFrom : 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 CreateInstanceFrom which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")>]
[<System.Security.SecurityCritical>]
static member CreateInstanceFrom : 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 CreateInstanceFrom (domain As AppDomain, assemblyFile 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 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(System::String ^ assemblyFile, 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 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);
static member CreateInstanceFrom : 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 CreateInstanceFrom which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")>]
static member CreateInstanceFrom : 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 CreateInstanceFrom (assemblyFile 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
- 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.
public:
static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(AppDomain ^ domain, System::String ^ assemblyFile, 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 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.SecurityCritical>]
static member CreateInstanceFrom : AppDomain * string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateInstanceFrom (domain As AppDomain, assemblyFile 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 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 |
- 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(System::String ^ assemblyFile, System::String ^ typeName, cli::array <System::Object ^> ^ activationAttributes);
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);
static member CreateInstanceFrom : string * string * obj[] -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateInstanceFrom (assemblyFile As String, typeName As String, activationAttributes As Object()) As ObjectHandle
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 |
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, System::String ^ assemblyFile, System::String ^ typeName);
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);
static member CreateInstanceFrom : AppDomain * string * string -> System.Runtime.Remoting.ObjectHandle
[<System.Security.SecurityCritical>]
static member CreateInstanceFrom : AppDomain * string * string -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateInstanceFrom (domain As AppDomain, assemblyFile As String, typeName As String) As ObjectHandle
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 |
- 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(System::String ^ assemblyFile, System::String ^ typeName);
public static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom (string assemblyFile, string typeName);
public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (string assemblyFile, string typeName);
static member CreateInstanceFrom : string * string -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateInstanceFrom (assemblyFile As String, typeName As String) As ObjectHandle
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,
SomeType::typeid->FullName);
// Call an instance method defined by the SomeType type using this object.
SomeType^ st = (SomeType^) oh->Unwrap();
st->DoSomething(5);
// 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);
// Create an instance of the SomeType class that is defined in this assembly.
let oh =
Activator.CreateInstanceFrom(Assembly.GetEntryAssembly().Location, typeof<SomeType>.FullName)
// Call an instance method defined by the SomeType type using this object.
let st = oh.Unwrap() :?> SomeType
st.DoSomething 5
' Create an instance of the SomeType class that is defined in this assembly.
Dim oh As System.Runtime.Remoting.ObjectHandle = _
Activator.CreateInstanceFrom(Assembly.GetEntryAssembly().CodeBase, _
GetType(SomeType).FullName)
' Call an instance method defined by the SomeType type using this object.
Dim st As SomeType = CType(oh.Unwrap(), SomeType)
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 |
- 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(System::String ^ assemblyFile, 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? 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);
static member CreateInstanceFrom : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateInstanceFrom (assemblyFile 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
- 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 |
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires :