Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Activator classe

 

Date de publication : novembre 2016

Contient des méthodes permettant de créer des types d'objets localement ou à distance, ou d'obtenir des références à des objets distants existants. Cette classe ne peut pas être héritée.

Espace de noms:   System
Assembly:  mscorlib (dans mscorlib.dll)


[ClassInterfaceAttribute(ClassInterfaceType.None)]
[ComVisibleAttribute(true)]
public sealed class Activator : _Activator

NomDescription
System_CAPS_pubmethodSystem_CAPS_staticCreateComInstanceFrom(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 par défaut.

System_CAPS_pubmethodSystem_CAPS_staticCreateComInstanceFrom(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 par défaut.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(ActivationContext)

Crée une instance du type désigné par l'objet ActivationContext spécifié.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(ActivationContext, String[])

Crée une instance du type désigné par l'objet ActivationContext spécifié et activé avec les données d'activation personnalisées spécifiées.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(AppDomain, String, String)

Crée une instance du type dont le nom est spécifié dans le domaine distant spécifié, en utilisant l'assembly nommé et le constructeur par défaut.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(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é, en utilisant l'assembly nommé et le constructeur qui correspond le mieux aux paramètres spécifiés.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(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é, en utilisant l'assembly nommé et le constructeur qui correspond le mieux aux paramètres spécifiés.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(String, String)

Crée une instance du type dont le nom est spécifié, en utilisant l'assembly nommé et le constructeur par défaut.

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

Crée une instance du type dont le nom est spécifié, à l'aide de l'assembly nommé et du constructeur qui correspond le mieux aux paramètres spécifiés.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(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 de l'assembly nommé et du constructeur qui correspond le mieux aux paramètres spécifiés.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(String, String, Object[])

Crée une instance du type dont le nom est spécifié, en utilisant l'assembly nommé et le constructeur par défaut.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type)

Crée une instance du type spécifié à l'aide du constructeur par défaut de ce type.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo)

Crée une instance du type spécifié à l'aide du constructeur qui correspond le mieux aux paramètres spécifiés.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo, Object[])

Crée une instance du type spécifié à l'aide du constructeur qui correspond le mieux aux paramètres spécifiés.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, Boolean)

Crée une instance du type spécifié à l'aide du constructeur par défaut de ce type.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, Object[])

Crée une instance du type spécifié à l'aide du constructeur qui correspond le mieux aux paramètres spécifiés.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, Object[], Object[])

Crée une instance du type spécifié à l'aide du constructeur qui correspond le mieux aux paramètres spécifiés.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance<T>()

Crée une instance du type désigné par le paramètre de type générique spécifié, à l'aide du constructeur sans paramètre.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstanceFrom(AppDomain, String, String)

Crée une instance du type dont le nom est spécifié dans le domaine distant spécifié, en utilisant le fichier d'assembly nommé et le constructeur par défaut.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstanceFrom(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é, en utilisant le fichier d'assembly nommé et le constructeur qui correspond le mieux aux paramètres spécifiés.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstanceFrom(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é, en utilisant le fichier d'assembly nommé et le constructeur qui correspond le mieux aux paramètres spécifiés.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstanceFrom(String, String)

Crée une instance du type dont le nom est spécifié, en utilisant le fichier d'assembly nommé et le constructeur par défaut.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstanceFrom(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.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstanceFrom(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.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstanceFrom(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 par défaut.

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodSystem_CAPS_staticGetObject(Type, String)

Crée un proxy pour l'objet connu indiqué par le type et l'URL spécifiés.

System_CAPS_pubmethodSystem_CAPS_staticGetObject(Type, String, Object)

Crée un proxy pour l'objet connu indiqué par le type, l'URL et les données de canal spécifiés.

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Activator.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch.

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Activator.GetTypeInfo(UInt32, UInt32, IntPtr)

Récupère les informations de type pour un objet, qui peuvent être utilisées ensuite pour obtenir les informations de type d'une interface.

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Activator.GetTypeInfoCount(UInt32)

Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Activator.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fournit l'accès aux propriétés et aux méthodes exposées par un objet.

Le CreateInstance méthode crée une instance d’un type défini dans un assembly en appelant le constructeur qui correspond le mieux les arguments spécifiés. Si aucun argument n’est spécifié, le constructeur qui ne prend aucun paramètre, autrement dit, le constructeur par défaut, est appelé.

Vous devez disposer des autorisations suffisantes pour rechercher et appeler un constructeur ; Sinon, une exception est levée. Par défaut, seuls les constructeurs publics sont considérées comme lors de la recherche un constructeur. Si aucun constructeur ou un constructeur par défaut ne peut être trouvé, une exception est levée.

Un paramètre binder spécifie un objet qui recherche un assembly pour un constructeur approprié. Vous pouvez spécifier votre propre classeur et critères de recherche. Si aucun classeur n’est spécifié, un binder par défaut est utilisé. Pour plus d'informations, consultez la classe System.Reflection.Binder et System.Reflection.BindingFlags.

Un paramètre de preuve affecte la stratégie de sécurité et les autorisations pour le constructeur. Pour plus d'informations, consultez la classe System.Security.Policy.Evidence.

Une instance d’un type peut être créée sur un site local ou distant. Si le type est créé à distance, un paramètre d’attribut d’activation Spécifie l’URI du site distant. L’appel à la création de l’instance peut passer par des sites intermédiaires avant d’atteindre le site distant. Autres attributs d’activation peuvent modifier l’environnement ou contexte dans lequel l’appel agit sur les sites distants et intermédiaires.

Si l’instance est créée localement, une référence à cet objet est retournée. Si l’instance est créée à distance, une référence à un proxy est retournée. L’objet distant est manipulée via le proxy comme s’il s’agissait d’un objet local.

Le GetObject méthode crée un proxy pour un objet en cours d’exécution à distance, un objet bien connu activé par serveur ou un service Web XML. Vous pouvez spécifier le support de connexion, autrement dit, le canal. Pour plus d'informations, consultez la classe System.Runtime.Remoting.Channels.ChannelServices.

Les assemblys contiennent des définitions de type. Le CreateInstance méthode crée une instance d’un type à partir d’un assembly en cours d’exécution. Le CreateInstanceFrom méthode crée une instance d’un fichier qui contient un assembly. Le CreateComInstanceFrom méthode crée une instance d’un objet COM à partir d’un fichier qui contient un assembly.

L’exemple suivant montre comment utiliser la Activator classe pour construire dynamiquement des objets au moment de l’exécution.

using System;
using System.Reflection;
using System.Text;

public class SomeType
{
    public void DoSomething(int x)
    {
        Console.WriteLine("100 / {0} = {1}", x, 100 / x);
    }
}

public class Example
{
    static void Main()
    {
        // Create an instance of the StringBuilder type using 
        // Activator.CreateInstance.
        Object o = Activator.CreateInstance(typeof(StringBuilder));

        // Append a string into the StringBuilder object and display the 
        // StringBuilder.
        StringBuilder sb = (StringBuilder) o;
        sb.Append("Hello, there.");
        Console.WriteLine(sb);

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

/* This code produces the following output:

Hello, there.
100 / 5 = 20
 */

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: