Informations
Le sujet que vous avez demandé est indiqué ci-dessous. Toutefois, ce sujet ne figure pas dans la bibliothèque.
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

WaitHandle, classe

Encapsule des objets spécifiques du système d'exploitation, qui attendent un accès exclusif aux ressources partagées.

Espace de noms :  System.Threading
Assembly :  mscorlib (dans mscorlib.dll)
[ComVisibleAttribute(true)]
public abstract class WaitHandle : MarshalByRefObject, 
	IDisposable

Le type WaitHandle expose les membres suivants.

  NomDescription
Méthode protégéePris en charge par XNA Framework9f7e54k1.PortableClassLibrary(fr-fr,VS.100).gifWaitHandleInitialise une nouvelle instance de la classe WaitHandle.
Début
  NomDescription
Propriété publiquePris en charge par XNA FrameworkHandle Obsolète. Obtient ou définit le handle du système d'exploitation natif.
Propriété publiqueSafeWaitHandleObtient ou définit le handle du système d'exploitation natif.
Début
  NomDescription
Méthode publiquePris en charge par XNA FrameworkCloseEn cas de substitution dans une classe dérivée, libère toutes les ressources détenues par le WaitHandle en cours.
Méthode publiqueCreateObjRefCrée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject.)
Méthode publique9f7e54k1.PortableClassLibrary(fr-fr,VS.100).gifDispose()Libère toutes les ressources utilisées par l'instance actuelle de la classe WaitHandle.
Méthode protégéePris en charge par XNA Framework9f7e54k1.PortableClassLibrary(fr-fr,VS.100).gifDispose(Boolean)En cas de substitution dans une classe dérivée, libère les ressources non managées utilisées par WaitHandle et libère éventuellement les ressources managées.
Méthode publiquePris en charge par XNA Framework9f7e54k1.PortableClassLibrary(fr-fr,VS.100).gifEquals(Object)Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégéePris en charge par XNA Framework9f7e54k1.PortableClassLibrary(fr-fr,VS.100).gifFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiquePris en charge par XNA Framework9f7e54k1.PortableClassLibrary(fr-fr,VS.100).gifGetHashCodeSert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publiqueGetLifetimeServiceRécupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject.)
Méthode publiquePris en charge par XNA Framework9f7e54k1.PortableClassLibrary(fr-fr,VS.100).gifGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueInitializeLifetimeServiceObtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject.)
Méthode protégéePris en charge par XNA Framework9f7e54k1.PortableClassLibrary(fr-fr,VS.100).gifMemberwiseClone()Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode protégéeMemberwiseClone(Boolean)Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject.)
Méthode publiqueMembre statiqueSignalAndWait(WaitHandle, WaitHandle)Signale un WaitHandle et attend un autre.
Méthode publiqueMembre statiqueSignalAndWait(WaitHandle, WaitHandle, Int32, Boolean)Signale un WaitHandle et en attend un autre, en spécifiant un délai sous la forme d'un entier signé de 32 bits et en spécifiant s'il faut sortir du domaine de synchronisation du contexte avant de commencer l'attente.
Méthode publiqueMembre statiqueSignalAndWait(WaitHandle, WaitHandle, TimeSpan, Boolean)Signale un WaitHandle et en attend un autre, en spécifiant le délai sous la forme de TimeSpan et en spécifiant s'il faut sortir du domaine de synchronisation du contexte avant de commencer l'attente.
Méthode publiquePris en charge par XNA Framework9f7e54k1.PortableClassLibrary(fr-fr,VS.100).gifToStringRetourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Méthode publiqueMembre statiqueWaitAll(WaitHandle[])Attend que tous les éléments du tableau spécifié reçoivent un signal.
Méthode publiqueMembre statiqueWaitAll(WaitHandle[], Int32)Attend que tous les éléments du tableau spécifié reçoivent un signal ; utilise une valeur Int32 pour spécifier l'intervalle de temps.
Méthode publiqueMembre statiqueWaitAll(WaitHandle[], TimeSpan)Attend que tous les éléments du tableau spécifié reçoivent un signal ; utilise une valeur TimeSpan pour spécifier l'intervalle de temps.
Méthode publiqueMembre statiqueWaitAll(WaitHandle[], Int32, Boolean)Attend que tous les éléments du tableau spécifié reçoivent un signal ; utilise une valeur Int32 pour spécifier l'intervalle de temps et spécifier s'il faut quitter le domaine de synchronisation avant l'attente.
Méthode publiqueMembre statiqueWaitAll(WaitHandle[], TimeSpan, Boolean)Attend que tous les éléments du tableau spécifié reçoivent un signal ; utilise une valeur TimeSpan pour spécifier l'intervalle de temps et spécifier s'il faut quitter le domaine de synchronisation avant l'attente.
Méthode publiqueMembre statiqueWaitAny(WaitHandle[])Attend qu'un des éléments du tableau spécifié reçoive un signal.
Méthode publiqueMembre statiqueWaitAny(WaitHandle[], Int32)Attend qu'un des éléments du tableau spécifié reçoive un signal ; utilise un entier signé 32 bits pour spécifier l'intervalle de temps.
Méthode publiqueMembre statiqueWaitAny(WaitHandle[], TimeSpan)Attend que l'un des éléments du tableau spécifié reçoive un signal ; utilise une valeur TimeSpan pour spécifier l'intervalle de temps.
Méthode publiqueMembre statiqueWaitAny(WaitHandle[], Int32, Boolean)Attend qu'un des éléments du tableau spécifié reçoive un signal ; utilise un entier signé 32 bits pour spécifier l'intervalle de temps et spécifier s'il faut quitter le domaine de synchronisation avant l'attente.
Méthode publiqueMembre statiqueWaitAny(WaitHandle[], TimeSpan, Boolean)Attend qu'un des éléments du tableau spécifié reçoive un signal ; utilise une valeur TimeSpan pour spécifier l'intervalle de temps et spécifier s'il faut quitter le domaine de synchronisation avant l'attente.
Méthode publiquePris en charge par XNA Framework9f7e54k1.PortableClassLibrary(fr-fr,VS.100).gifWaitOne()Bloque le thread actuel jusqu'à ce que le WaitHandle actuel reçoive un signal.
Méthode publiqueWaitOne(Int32)Bloque le thread actuel jusqu'à ce que le WaitHandle actuel reçoive un signal ; utilise un entier signé 32 bits pour spécifier l'intervalle de temps.
Méthode publiqueWaitOne(TimeSpan)Bloque le thread actuel jusqu'à ce que l'instance actuelle reçoive un signal ; utilise une valeur TimeSpan pour spécifier l'intervalle de temps.
Méthode publiquePris en charge par XNA FrameworkWaitOne(Int32, Boolean)Bloque le thread actuel jusqu'à ce que le WaitHandle actuel reçoive un signal ; utilise un entier signé 32 bits pour spécifier l'intervalle de temps et s'il faut quitter le domaine de synchronisation avant l'attente.
Méthode publiqueWaitOne(TimeSpan, Boolean)Bloque le thread actuel jusqu'à ce que l'instance actuelle reçoive un signal, en utilisant TimeSpan pour spécifier l'intervalle de temps et s'il faut quitter le domaine de synchronisation avant l'attente.
Début
  NomDescription
Champ protégéMembre statiquePris en charge par XNA FrameworkInvalidHandleReprésente un handle du système d'exploitation non valide. Ce champ est en lecture seule.
Champ publicMembre statiqueWaitTimeoutIndique que le délai fixé pour une opération WaitAny a été dépassé sans qu'aucun des handles d'attente ait été signalé. Ce champ est constant.
Début
  NomDescription
Implémentation d'interface expliciteMéthode privéePris en charge par XNA FrameworkIDisposable.DisposeInfrastructure. Libère toutes les ressources utilisées par WaitHandle.
Début

Cette classe est généralement utilisée comme classe de base des objets de synchronisation. Les classes dérivées de WaitHandle définissent un mécanisme de signalisation pour indiquer la capture ou la libération d'un accès à une ressource partagée, mais elles utilisent les méthodes WaitHandle héritées pour assurer le blocage pendant les attentes d'accès aux ressources partagées.

Utilisez les méthodes statiques de cette classe pour bloquer un thread tant qu'un ou plusieurs objets de synchronisation n'ont pas reçu de signal.

WaitHandle implémente le modèle Dispose. Consultez Implémentation des méthodes Finalize et Dispose pour nettoyer des ressources non managées. Lorsque vous dérivez de WaitHandle, utilisez la propriété SafeWaitHandle pour stocker votre handle de système d'exploitation natif. Vous n'avez pas besoin de substituer la méthode Dispose protégée, à moins que vous n'utilisiez des ressources non managées supplémentaires.

L'exemple de code suivant affiche la façon dont deux threads peuvent effectuer des tâches en arrière-plan pendant que le thread principal attend que les tâches prennent fin à l'aide des méthodes WaitAny et WaitAll statiques de la classe WaitHandle.


using System;
using System.Threading;

public sealed class App 
{
    // Define an array with two AutoResetEvent WaitHandles.
    static WaitHandle[] waitHandles = new WaitHandle[] 
    {
        new AutoResetEvent(false),
        new AutoResetEvent(false)
    };

    // Define a random number generator for testing.
    static Random r = new Random();

    static void Main() 
    {
        // Queue up two tasks on two different threads; 
        // wait until all tasks are completed.
        DateTime dt = DateTime.Now;
        Console.WriteLine("Main thread is waiting for BOTH tasks to complete.");
        ThreadPool.QueueUserWorkItem(new WaitCallback(DoTask), waitHandles[0]);
        ThreadPool.QueueUserWorkItem(new WaitCallback(DoTask), waitHandles[1]);
        WaitHandle.WaitAll(waitHandles);
        // The time shown below should match the longest task.
        Console.WriteLine("Both tasks are completed (time waited={0})", 
            (DateTime.Now - dt).TotalMilliseconds);

        // Queue up two tasks on two different threads; 
        // wait until any tasks are completed.
        dt = DateTime.Now;
        Console.WriteLine();
        Console.WriteLine("The main thread is waiting for either task to complete.");
        ThreadPool.QueueUserWorkItem(new WaitCallback(DoTask), waitHandles[0]);
        ThreadPool.QueueUserWorkItem(new WaitCallback(DoTask), waitHandles[1]);
        int index = WaitHandle.WaitAny(waitHandles);
        // The time shown below should match the shortest task.
        Console.WriteLine("Task {0} finished first (time waited={1}).",
            index + 1, (DateTime.Now - dt).TotalMilliseconds);
    }

    static void DoTask(Object state) 
    {
        AutoResetEvent are = (AutoResetEvent) state;
        int time = 1000 * r.Next(2, 10);
        Console.WriteLine("Performing a task for {0} milliseconds.", time);
        Thread.Sleep(time);
        are.Set();
    }
}

// This code produces output similar to the following:
//
//  Main thread is waiting for BOTH tasks to complete.
//  Performing a task for 7000 milliseconds.
//  Performing a task for 4000 milliseconds.
//  Both tasks are completed (time waited=7064.8052)
// 
//  The main thread is waiting for either task to complete.
//  Performing a task for 2000 milliseconds.
//  Performing a task for 2000 milliseconds.
//  Task 1 finished first (time waited=2000.6528).


.NET Framework

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

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Pris en charge dans :

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

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.

Ce type est thread-safe.

Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.

Ajouts de la communauté

Afficher:
© 2014 Microsoft. Tous droits réservés.