Activator.CreateComInstanceFrom Méthode
Définition
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 de l'objet COM dont le nom est spécifié.
Surcharges
CreateComInstanceFrom(String, String) |
Crée une instance de l’objet COM dont le nom est spécifié, en utilisant le fichier d’assembly nommé et le constructeur sans paramètre. |
CreateComInstanceFrom(String, String, Byte[], AssemblyHashAlgorithm) |
Crée une instance de l’objet COM dont le nom est spécifié, en utilisant le fichier d’assembly nommé et le constructeur sans paramètre. |
CreateComInstanceFrom(String, String)
Crée une instance de l’objet COM dont le nom est spécifié, en utilisant le fichier d’assembly nommé et le constructeur sans paramètre.
public:
static System::Runtime::Remoting::ObjectHandle ^ CreateComInstanceFrom(System::String ^ assemblyName, System::String ^ typeName);
public static System.Runtime.Remoting.ObjectHandle CreateComInstanceFrom (string assemblyName, string typeName);
static member CreateComInstanceFrom : string * string -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateComInstanceFrom (assemblyName As String, typeName As String) As ObjectHandle
Paramètres
- assemblyName
- String
Nom d'un fichier qui contient un assembly dans lequel le type nommé typeName
est recherché.
- typeName
- String
Nom du type dont une instance sera créée.
Retours
Handle qui doit être décompressé pour accéder à l’objet nouvellement créé ou null
pour Nullable<T> les instances.
Exceptions
typeName
ou assemblyName
est null
.
Il est impossible de créer une instance par l’intermédiaire de COM.
- ou -
typename
est introuvable dans assemblyName
.
Aucun constructeur correspondant n’a été trouvé.
assemblyName
est introuvable ou le module que vous essayez de charger ne spécifie pas une extension de nom de fichier.
Il est impossible de créer une instance d’une classe abstraite.
- ou -
Ce membre a été appelé avec un mécanisme de liaison tardive.
L’appelant ne peut pas fournir d’attributs d’activation pour un objet qui n’hérite pas de MarshalByRefObject.
assemblyName
est la chaîne vide ("").
Remarques
Utilisez la ObjectHandle.Unwrap méthode pour désenraper la valeur de retour.
Un System.Runtime.InteropServices.ComVisibleAttribute attribut avec la valeur de true
doit être appliqué explicitement ou par défaut au type COM afin que la CreateComInstanceFrom méthode puisse créer un instance de ce type ; sinon, TypeLoadException est levée.
Pour plus d’informations sur d’autres exceptions pouvant être levées par des Assembly.LoadFrom méthodes appelées, consultez la section Exceptions des méthodes et CreateInstance .
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 à
CreateComInstanceFrom(String, String, Byte[], AssemblyHashAlgorithm)
Crée une instance de l’objet COM dont le nom est spécifié, en utilisant le fichier d’assembly nommé et le constructeur sans paramètre.
public:
static System::Runtime::Remoting::ObjectHandle ^ CreateComInstanceFrom(System::String ^ assemblyName, System::String ^ typeName, cli::array <System::Byte> ^ hashValue, System::Configuration::Assemblies::AssemblyHashAlgorithm hashAlgorithm);
public static System.Runtime.Remoting.ObjectHandle CreateComInstanceFrom (string assemblyName, string typeName, byte[] hashValue, System.Configuration.Assemblies.AssemblyHashAlgorithm hashAlgorithm);
static member CreateComInstanceFrom : string * string * byte[] * System.Configuration.Assemblies.AssemblyHashAlgorithm -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateComInstanceFrom (assemblyName As String, typeName As String, hashValue As Byte(), hashAlgorithm As AssemblyHashAlgorithm) As ObjectHandle
Paramètres
- assemblyName
- String
Nom d'un fichier qui contient un assembly dans lequel le type nommé typeName
est recherché.
- typeName
- String
Nom du type dont une instance sera créée.
- hashValue
- Byte[]
Valeur du code de hachage calculé.
- hashAlgorithm
- AssemblyHashAlgorithm
Algorithme de hachage utilisé pour hacher les fichiers et générer le nom fort.
Retours
Handle qui doit être décompressé pour accéder à l’objet nouvellement créé ou null
pour Nullable<T> les instances.
Exceptions
typeName
ou assemblyName
est null
.
assemblyName
est la chaîne vide ("").
Un assembly ou un module a été chargé à deux reprises avec deux preuves différentes.
- ou -
assemblyName
dépasse la longueur maximale définie par le système.
assemblyName
est introuvable ou le module que vous essayez de charger ne spécifie pas une extension de nom de fichier.
assemblyName
a été trouvé, mais impossible de le charger.
assemblyName
n’est pas un assembly valide.
Une base de code qui ne commence pas par “file://” a été spécifiée sans le WebPermission
requis.
Il est impossible de créer une instance par l’intermédiaire de COM.
- ou -
typename
est introuvable dans assemblyName
.
Aucun constructeur correspondant n’a été trouvé.
Impossible de créer une instance d’une classe abstraite.
- ou -
Ce membre a été appelé avec un mécanisme de liaison tardive.
L’appelant ne peut pas fournir d’attributs d’activation pour un objet qui n’hérite pas de MarshalByRefObject.
Remarques
Utilisez la ObjectHandle.Unwrap méthode pour désenraper la valeur de retour.
Un System.Runtime.InteropServices.ComVisibleAttribute attribut avec la valeur de true
doit être appliqué explicitement ou par défaut au type COM afin que la CreateComInstanceFrom méthode puisse créer un instance de ce type ; sinon, TypeLoadException est levée.
Pour plus d’informations sur d’autres exceptions pouvant être levées par des Assembly.LoadFrom méthodes appelées, consultez la section Exceptions des méthodes et CreateInstance .
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 à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de l’année 2024, nous abandonnerons progressivement le mécanisme de retour d’information GitHub Issues pour le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez :Soumettre et afficher des commentaires pour