Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

Activator, classe

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)

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

Le type Activator expose les membres suivants.

  NomDescription
Méthode publiqueMembre statiqueCreateComInstanceFrom(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 qui correspond le mieux aux paramètres spécifiés.
Méthode publiqueMembre statiqueCreateComInstanceFrom(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.
Méthode publiqueMembre statiqueCreateInstance(ActivationContext)Crée une instance du type désigné par l'objet ActivationContext spécifié.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCreateInstance(Type)Crée une instance du type spécifié à l'aide du constructeur par défaut de ce type.
Méthode publiqueMembre statiqueCreateInstance(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.
Méthode publiqueMembre statiqueCreateInstance(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.
Méthode publiqueMembre statiqueCreateInstance(Type, Boolean)Crée une instance du type spécifié à l'aide du constructeur par défaut de ce type.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCreateInstance(Type, Object[])Crée une instance du type spécifié à l'aide du constructeur qui correspond le mieux aux paramètres spécifiés.
Méthode publiqueMembre statiqueCreateInstance(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.
Méthode publiqueMembre statiqueCreateInstance(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.
Méthode publiqueMembre statiqueCreateInstance(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.
Méthode publiqueMembre statiqueCreateInstance(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.
Méthode publiqueMembre statiqueCreateInstance(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.
Méthode publiqueMembre statiqueCreateInstance(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.
Méthode publiqueMembre statiqueCreateInstance(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.
Méthode publiqueMembre statiqueCreateInstance(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.
Méthode publiqueMembre statiqueCreateInstance(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.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCreateInstance<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.
Méthode publiqueMembre statiqueCreateInstanceFrom(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.
Méthode publiqueMembre statiqueCreateInstanceFrom(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.
Méthode publiqueMembre statiqueCreateInstanceFrom(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.
Méthode publiqueMembre statiqueCreateInstanceFrom(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.
Méthode publiqueMembre statiqueCreateInstanceFrom(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.
Méthode publiqueMembre statiqueCreateInstanceFrom(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.
Méthode publiqueMembre statiqueCreateInstanceFrom(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.
Méthode publiquePris en charge par XNA FrameworkEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueMembre statiqueGetObject(Type, String)Crée un proxy pour l'objet connu indiqué par le type et l'URL spécifiés.
Méthode publiqueMembre statiqueGetObject(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.
Méthode publiquePris en charge par XNA FrameworkGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Début

  NomDescription
Implémentation d'interface expliciteMéthode privée_Activator.GetIDsOfNamesMappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch.
Implémentation d'interface expliciteMéthode privée_Activator.GetTypeInfoRécupère les informations de type pour un objet, qui peuvent être utilisées ensuite pour obtenir les informations de type d'une interface.
Implémentation d'interface expliciteMéthode privée_Activator.GetTypeInfoCountRécupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1).
Implémentation d'interface expliciteMéthode privée_Activator.InvokeFournit l'accès aux propriétés et aux méthodes exposées par un objet.
Début

La méthode CreateInstance crée une instance d'un type défini dans un assembly en appelant le constructeur qui correspond le mieux aux arguments spécifiés. Si aucun argument n'est spécifié, le constructeur qui ne prend aucun paramètre, c'est-à-dire le constructeur par défaut, est appelé.

Vous devez posséder les autorisations suffisantes pour rechercher et appeler un constructeur ; sinon, une exception est levée. Par défaut, seuls les constructeurs publics sont pris en compte lors de la recherche d'un constructeur. Si aucun constructeur correspondant ou aucun constructeur par défaut n'est trouvé, une exception est levée.

Un paramètre binder spécifie un objet qui recherche un constructeur approprié dans un assembly. Vous pouvez spécifier votre propre classeur et vos critères de recherche. Si aucun classeur n'est spécifié, un classeur 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 du constructeur. Pour plus d'informations, consultez la classe System.Security.Policy.Evidence.

Une instance d'un type peut être créée au niveau d'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 permettant de créer une instance peut passer par des sites intermédiaires avant d'atteindre le site distant. D'autres attributs d'activation peuvent modifier l'environnement, ou le contexte, dans lequel l'appel agit au niveau du site distant et des sites 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é à l'aide du proxy comme s'il s'agissait d'un objet local.

La méthode GetObject crée un proxy pour un objet distant en cours d'exécution, pour un objet connu activé par le serveur ou pour un service Web XML. Vous pouvez spécifier le moyen de connexion, c'est-à-dire le canal. Pour plus d'informations, consultez la classe System.Runtime.Remoting.Channels.ChannelServices.

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

L'exemple suivant illustre l'utilisation de la classe Activator 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
 */


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft