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é, à 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(String, String, Object[])

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

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

ObjectHandle

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

Exceptions

ArgumentNullException

typeName est null.

MissingMethodException

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

TypeLoadException

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

FileNotFoundException

assemblyFile n’a pas été trouvé.

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é par réflexion, a levé une exception.

NotSupportedException

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

SecurityException

L’appelant a la FileIOPermissionrequise.

BadImageFormatException

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.

CreateInstanceFrom(String, String)

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

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

ObjectHandle

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

Exceptions

ArgumentNullException

typeName est null.

MissingMethodException

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

TypeLoadException

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

FileNotFoundException

assemblyFile n’a pas été trouvé.

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é par réflexion, a levé une exception.

SecurityException

L’appelant a la FileIOPermissionrequise.

BadImageFormatException

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.

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

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

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

ObjectHandle

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

Exceptions

ArgumentNullException

typeName est null.

MissingMethodException

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

TypeLoadException

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

FileNotFoundException

assemblyFile n’a pas été trouvé.

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é par réflexion, a levé une exception.

SecurityException

L’appelant n’a pas la FileIOPermissionrequise.

NotSupportedException

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

BadImageFormatException

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.