Activator.CreateInstanceFrom Méthode

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, 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

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

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")]
public static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom(string assemblyFile, string typeName, object?[]? activationAttributes);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")>]
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 à 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 objet unique 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> les instances.

Attributs

RequiresUnreferencedCodeAttribute

Exceptions

ArgumentNullException

typeName a la valeur 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 valeur requise FileIOPermission.

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 ObjectHandle.Unwrap méthode 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 Assembly.LoadFrom méthodes et CreateInstance méthodes.

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

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")]
public static System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom(string assemblyFile, string typeName);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")>]
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 à 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> les instances.

Attributs

RequiresUnreferencedCodeAttribute

Exceptions

ArgumentNullException

typeName a la valeur 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 valeur requise FileIOPermission.

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 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,
                                 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 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 Assembly.LoadFrom méthodes et CreateInstance méthodes.

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

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")]
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.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")>]
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 à créer une instance de.

ignoreCase

Boolean

true pour spécifier que la recherche 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 typeName constructeur. Si bindingAttr la valeur est égale à zéro, une recherche sensible à la casse pour les constructeurs publics est effectuée.

binder

Binder

Objet qui utilise bindingAttr et args recherche et identifie le typeName constructeur. Si binder c’est nullle cas, 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. S’il args s’agit d’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 des args types formels déclarés pour le typeName constructeur. Si culture c’est nullle cas, le CultureInfo 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 objet unique 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> les instances.

Attributs

RequiresUnreferencedCodeAttribute

Exceptions

ArgumentNullException

typeName a la valeur 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 valeur requise FileIOPermission.

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 ObjectHandle.Unwrap méthode 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 Assembly.LoadFrom méthodes et CreateInstance méthodes.