Activator.CreateInstanceFrom Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

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(String, String, Object[])	Crée une instance du type dont le nom est spécifié, en utilisant le fichier d’assembly nommé et le constructeur sans paramètre.
CreateInstanceFrom(String, String)	Crée une instance du type dont le nom est spécifié, en utilisant le fichier d’assembly nommé et le 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(String, String, Object[])

Crée une instance du type 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 ^ 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);

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 dans lequel le type nommé typeName est recherché.

typeName

String

Nom du type dont une instance sera créée.

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

ObjectHandle

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

Exceptions

ArgumentNullException

typeName a la valeur null.

MissingMethodException

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

TypeLoadException

typename est introuvable dans assemblyFile.

FileNotFoundException

assemblyFile est introuvable.

MethodAccessException

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

MemberAccessException

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

TargetInvocationException

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

NotSupportedException

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

SecurityException

L'appelant a les FileIOPermission nécessaires.

BadImageFormatException

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

Remarques

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

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 .

CreateInstanceFrom(String, String)

Crée une instance du type 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 ^ CreateInstanceFrom(System::String ^ assemblyFile, System::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 dans lequel le type nommé typeName est recherché.

typeName

String

Nom du type dont une instance sera créée.

Retours

ObjectHandle

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

Exceptions

ArgumentNullException

typeName a la valeur null.

MissingMethodException

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

TypeLoadException

typename est introuvable dans assemblyFile.

FileNotFoundException

assemblyFile est introuvable.

MethodAccessException

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

MemberAccessException

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

TargetInvocationException

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

SecurityException

L'appelant a les FileIOPermission nécessaires.

BadImageFormatException

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

Exemples

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

// 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 ObjectHandle.Unwrap méthode pour désenraper la valeur de retour.

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 .

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.

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);

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 dans lequel le type nommé typeName est recherché.

typeName

String

Nom du type dont une instance sera créée.

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

ObjectHandle

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

Exceptions

ArgumentNullException

typeName a la valeur null.

MissingMethodException

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

TypeLoadException

typename est introuvable dans assemblyFile.

FileNotFoundException

assemblyFile est introuvable.

MethodAccessException

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

MemberAccessException

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

TargetInvocationException

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

SecurityException

L'appelant n'a pas l'autorisation FileIOPermission requise.

NotSupportedException

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

BadImageFormatException

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

Remarques

Utilisez la ObjectHandle.Unwrap méthode pour désencapsuler 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 Assembly.LoadFrom méthodes et CreateInstance .