ThreadPool Classe

Definizione

public ref class ThreadPool abstract sealed

public ref class ThreadPool sealed

public static class ThreadPool

public sealed class ThreadPool

type ThreadPool = class

Public Class ThreadPool

Public NotInheritable Class ThreadPool

Ereditarietà

Object

ThreadPool

Esempio

Nell'esempio seguente il thread dell'applicazione principale accoda un metodo denominato ThreadProc per l'esecuzione in un thread del pool di thread, dorme per un secondo e quindi termina. Il ThreadProc metodo visualizza semplicemente un messaggio.

using namespace System;
using namespace System::Threading;

ref class Example
{
public:

   // This thread procedure performs the task.
   static void ThreadProc(Object^ stateInfo)
   {
      
      // No state object was passed to QueueUserWorkItem, so stateInfo is 0.
      Console::WriteLine( "Hello from the thread pool." );
   }
};

int main()
{
   // Queue the task.
   ThreadPool::QueueUserWorkItem(gcnew WaitCallback(Example::ThreadProc));

   Console::WriteLine("Main thread does some work, then sleeps.");
   
   Thread::Sleep(1000);
   Console::WriteLine("Main thread exits.");
   return 0;
}
// The example displays output like the following:
//       Main thread does some work, then sleeps.
//       Hello from the thread pool.
//       Main thread exits.

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.

Se si commenta la chiamata al Thread.Sleep metodo, il thread principale viene chiuso prima dell'esecuzione del metodo nel thread del pool di thread. Il pool di thread usa thread in background, che non mantengono l'applicazione in esecuzione se tutti i thread in primo piano hanno terminato. Si tratta di un semplice esempio di una condizione di razza.

Commenti

Molte applicazioni creano thread che impiegano molto tempo nello stato di sospensione, in attesa che si verifichi un evento. Altri thread possono immettere uno stato di sospensione solo per essere svegliati periodicamente per eseguire il polling per una modifica o aggiornare le informazioni sullo stato. Il pool di thread consente di usare i thread in modo più efficiente fornendo all'applicazione un pool di thread di lavoro gestiti dal sistema. Esempi di operazioni che usano thread del pool di thread includono quanto segue:

• Quando si crea un Task oggetto o Task<TResult> per eseguire un'attività in modo asincrono, per impostazione predefinita l'attività viene pianificata per l'esecuzione in un thread del pool di thread.

• I timer asincroni usano il pool di thread. I thread del System.Threading.Timer pool di thread eseguono callback dalla classe e generano eventi dalla System.Timers.Timer classe.

• Quando si usano handle di attesa registrati, un thread di sistema monitora lo stato degli handle di attesa. Al termine di un'operazione di attesa, un thread di lavoro dal pool di thread esegue la funzione di callback corrispondente.

• Quando si chiama il metodo per accodare un metodo per l'esecuzione QueueUserWorkItem in un thread del pool di thread. A tale scopo, passare il metodo a un WaitCallback delegato. Il delegato ha la firma

  void WaitCallback(Object state)
  

  Sub WaitCallback(state As Object)
  

  dove state è un oggetto che contiene dati da usare dal delegato. I dati effettivi possono essere passati al delegato chiamando il QueueUserWorkItem(WaitCallback, Object) metodo .

È anche possibile accodare elementi di lavoro non correlati a un'operazione di attesa al pool di thread. Per richiedere che un elemento di lavoro venga gestito da un thread nel pool di thread, chiamare il QueueUserWorkItem metodo . Questo metodo accetta come parametro un riferimento al metodo o al delegato che verrà chiamato dal thread selezionato dal pool di thread. Non è possibile annullare un elemento di lavoro dopo la coda.

I timer della coda timer e le operazioni di attesa registrate usano anche il pool di thread. Le funzioni di callback vengono accodate al pool di thread.

Esiste un pool di thread per processo. A partire da .NET Framework 4 la dimensione predefinita del pool di thread per un processo dipende da diversi fattori, ad esempio la dimensione dello spazio degli indirizzi virtuali. Un processo può chiamare il metodo GetMaxThreads per determinare il numero di thread. Il numero di thread nel pool di thread può essere modificato usando il SetMaxThreads metodo . Ogni thread usa le dimensioni predefinite dello stack ed esegue con la priorità predefinita.

Il pool di thread fornisce nuovi thread di lavoro o thread di completamento di I/O su richiesta finché non raggiunge il massimo per ogni categoria. Quando viene raggiunto un massimo, il pool di thread può creare thread aggiuntivi in tale categoria o attendere il completamento di alcune attività. A partire da .NET Framework 4 il pool di thread crea ed elimina thread di lavoro per ottimizzare la velocità effettiva, definita come numero di attività completate per unità di tempo. Un numero troppo ridotto di thread potrebbe non usare in modo ottimale le risorse disponibili, mentre troppi thread potrebbero aumentare il conflitto per le risorse.

È possibile usare il metodo GetMinThreads per ottenere questi valori minimi.

Proprietà

Metodi

Si applica a

Thread safety

Questo tipo è thread-safe.

Vedi anche

• Thread e threading
• Pool di thread gestiti