ThreadPool Classe

Définition

public ref class ThreadPool sealed

public ref class ThreadPool abstract sealed

public sealed class ThreadPool

public static class ThreadPool

type ThreadPool = class

Public NotInheritable Class ThreadPool

Public Class ThreadPool

Héritage

Object

ThreadPool

Exemples

Dans l’exemple suivant, le thread d’application principal met en file d’attente une méthode nommée ThreadProc pour s’exécuter sur un thread de pool de threads, se met en veille pendant une seconde, puis se ferme. La ThreadProc méthode affiche simplement un message.

using System;
using System.Threading;

public class Example 
{
    public static void Main() 
    {
        // Queue the task.
        ThreadPool.QueueUserWorkItem(ThreadProc);
        Console.WriteLine("Main thread does some work, then sleeps.");
        Thread.Sleep(1000);

        Console.WriteLine("Main thread exits.");
    }

    // This thread procedure performs the task.
    static void ThreadProc(Object stateInfo) 
    {
        // No state object was passed to QueueUserWorkItem, so stateInfo is null.
        Console.WriteLine("Hello from the thread pool.");
    }
}
// The example displays output like the following:
//       Main thread does some work, then sleeps.
//       Hello from the thread pool.
//       Main thread exits.

Imports System.Threading

Public Module Example
    Public Sub Main()
        ' Queue the work for execution.
        ThreadPool.QueueUserWorkItem(AddressOf ThreadProc)
        
        Console.WriteLine("Main thread does some work, then sleeps.")

        Thread.Sleep(1000)

        Console.WriteLine("Main thread exits.")
    End Sub

    ' This thread procedure performs the task.
    Sub ThreadProc(stateInfo As Object)
        ' No state object was passed to QueueUserWorkItem, so stateInfo is null.
        Console.WriteLine("Hello from the thread pool.")
    End Sub
End Module
' The example displays output like the following:
'       Main thread does some work, then sleeps.
'       Hello from the thread pool.
'       Main thread exits.

Si vous commentez l’appel à la Thread.Sleep méthode, le thread principal se ferme avant l’exécution de la méthode sur le thread du pool de threads. Le pool de threads utilise des threads d’arrière-plan, qui ne conservent pas l’exécution de l’application si tous les threads de premier plan se sont arrêtés. (Il s’agit d’un exemple simple d’une condition de race.)

Remarques

De nombreuses applications créent des threads qui passent beaucoup de temps dans l’état de veille, en attendant qu’un événement se produise. D’autres threads peuvent entrer un état de veille uniquement pour être réveillés régulièrement pour interroger une modification ou mettre à jour les informations d’état. Le pool de threads vous permet d’utiliser des threads plus efficacement en fournissant à votre application un pool de threads de travail gérés par le système. Voici quelques exemples d’opérations qui utilisent des threads de pool de threads :

• Lorsque vous créez un ou Task<TResult> un objet pour effectuer une Task tâche de manière asynchrone, par défaut, la tâche est planifiée pour s’exécuter sur un thread de pool de threads.

• Les minuteurs asynchrones utilisent le pool de threads. Les threads de pool de threads exécutent des rappels à partir de la System.Threading.Timer classe et déclenchent des événements de la System.Timers.Timer classe.

• Lorsque vous utilisez des handles d’attente inscrits, un thread système surveille l’état des handles d’attente. Lorsqu’une opération d’attente se termine, un thread de travail du pool de threads exécute la fonction de rappel correspondante.

• Lorsque vous appelez la QueueUserWorkItem méthode pour mettre en file d’attente une méthode pour l’exécution sur un thread de pool de threads. Pour ce faire, transmettez la méthode à un WaitCallback délégué. Le délégué a la signature

  void WaitCallback(Object state)
  

  Sub WaitCallback(state As Object)
  

  où state est un objet qui contient des données à utiliser par le délégué. Les données réelles peuvent être transmises au délégué en appelant la QueueUserWorkItem(WaitCallback, Object) méthode.

Vous pouvez également mettre en file d’attente les éléments de travail qui ne sont pas liés à une opération d’attente au pool de threads. Pour demander qu’un élément de travail soit géré par un thread dans le pool de threads, appelez la QueueUserWorkItem méthode. Cette méthode prend comme paramètre une référence à la méthode ou au délégué qui sera appelé par le thread sélectionné à partir du pool de threads. Il n’existe aucun moyen d’annuler un élément de travail une fois qu’il a été mis en file d’attente.

Les minuteurs de file d’attente du minuteur et les opérations d’attente inscrites utilisent également le pool de threads. Leurs fonctions de rappel sont mises en file d’attente vers le pool de threads.

Il existe un pool de threads par processus. À compter de la .NET Framework 4, la taille par défaut du pool de threads pour un processus dépend de plusieurs facteurs, tels que la taille de l’espace d’adressage virtuel. Un processus peut appeler la GetMaxThreads méthode pour déterminer le nombre de threads. Le nombre de threads dans le pool de threads peut être modifié à l’aide de la SetMaxThreads méthode. Chaque thread utilise la taille de pile par défaut et s’exécute au niveau de la priorité par défaut.

Le pool de threads fournit de nouveaux threads de travail ou threads d’achèvement d’E/S à la demande jusqu’à ce qu’il atteigne le maximum pour chaque catégorie. Lorsqu’un maximum est atteint, le pool de threads peut créer des threads supplémentaires dans cette catégorie ou attendre que certaines tâches se terminent. À compter de l’infrastructure .NET 4, le pool de threads crée et détruit les threads de travail afin d’optimiser le débit, qui est défini comme le nombre de tâches qui se terminent par unité de temps. Trop peu de threads peuvent ne pas utiliser de manière optimale les ressources disponibles, tandis que trop de threads peuvent augmenter la contention des ressources.

Vous pouvez utiliser la GetMinThreads méthode pour obtenir ces valeurs minimales.

Cohérence de thread

Ce type est thread safe.

Voir aussi

• Threads et gestion de threads
• Regroupement de threads managés