ThreadPool Klasse

Definition

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

Vererbung

Object

ThreadPool

Beispiele

Im folgenden Beispiel stellt der Hauptanwendungsthread eine Methode mit dem Namen ThreadProc für die Ausführung in einem Threadpoolthread in die Warteschlange, schläft eine Sekunde lang und wird dann beendet. Die ThreadProc -Methode zeigt einfach eine Meldung an.

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.

Wenn Sie den Aufruf der Thread.Sleep -Methode auskommentieren, wird der Hauptthread beendet, bevor die Methode im Threadpoolthread ausgeführt wird. Der Threadpool verwendet Hintergrundthreads, die die Anwendung nicht laufen lassen, wenn alle Vordergrundthreads beendet wurden. (Dies ist ein einfaches Beispiel für eine Racebedingung.)

Hinweise

Viele Anwendungen erstellen Threads, die viel Zeit im Ruhezustand verbringen und auf ein Ereignis warten. Andere Threads können nur in einen Ruhezustand versetzt werden, um regelmäßig aktiviert zu werden, um nach Änderungs- oder Aktualisierungsstatusinformationen abzufragen. Mit dem Threadpool können Sie Threads effizienter verwenden, indem Sie Ihrer Anwendung einen Pool von Workerthreads bereitstellen, die vom System verwaltet werden. Beispiele für Vorgänge, die Threadpoolthreads verwenden:

• Wenn Sie ein Task - oder Task<TResult> -Objekt erstellen, um eine Aufgabe asynchron auszuführen, ist standardmäßig die Ausführung der Aufgabe in einem Threadpoolthread geplant.

• Asynchrone Timer verwenden den Threadpool. Threadpoolthreads führen Rückrufe aus der System.Threading.Timer -Klasse aus und lösen Ereignisse aus der System.Timers.Timer -Klasse aus.

• Wenn Sie registrierte Wartehandles verwenden, überwacht ein Systemthread den Status der Wartehandles. Wenn ein Wartevorgang abgeschlossen ist, führt ein Workerthread aus dem Threadpool die entsprechende Rückruffunktion aus.

• Wenn Sie die QueueUserWorkItem -Methode aufrufen, um eine Methode für die Ausführung in einem Threadpoolthread in die Warteschlange zu stellen. Hierzu übergeben Sie der Methode einen WaitCallback Delegaten. Der Delegat verfügt über die Signatur.

  void WaitCallback(Object state)
  

  Sub WaitCallback(state As Object)
  

  wobei state ein Objekt ist, das Daten enthält, die vom Delegaten verwendet werden sollen. Die tatsächlichen Daten können durch Aufrufen der -Methode an den QueueUserWorkItem(WaitCallback, Object) Delegaten übergeben werden.

Sie können auch Arbeitselemente, die sich nicht auf einen Wartevorgang beziehen, mit dem Threadpool in die Warteschlange stellen. Um anzufordern, dass ein Arbeitselement von einem Thread im Threadpool behandelt wird, rufen Sie die -Methode auf QueueUserWorkItem . Diese Methode verwendet als Parameter einen Verweis auf die Methode oder den Delegaten, der von dem aus dem Threadpool ausgewählten Thread aufgerufen wird. Es gibt keine Möglichkeit, ein Arbeitselement abzubrechen, nachdem es in die Warteschlange gestellt wurde.

Timer-Warteschlangen-Timer und registrierte Wartevorgänge verwenden auch den Threadpool. Ihre Rückruffunktionen werden im Threadpool in die Warteschlange eingereiht.

Pro Prozess gibt es einen Threadpool. Ab .NET Framework 4 ist die Standardgröße des Threadpools für einen Prozess von mehreren Faktoren abhängig, z.B. von der Größe des virtuellen Adressraums. Ein Prozess kann die GetMaxThreads-Methode aufrufen, um die Anzahl der Threads zu bestimmen. Die Anzahl der Threads im Threadpool kann mithilfe der SetMaxThreads -Methode geändert werden. Jeder Thread verwendet die Standardstapelgröße und wird mit der Standardpriorität ausgeführt.

Der Threadpool stellt bei Bedarf neue Workerthreads oder E/A-Vervollständigungsthreads bereit, bis er das Maximum für jede Kategorie erreicht. Wenn ein Maximum erreicht ist, kann der Threadpool zusätzliche Threads in dieser Kategorie erstellen oder warten, bis einige Aufgaben abgeschlossen sind. Ab .NET Framework 4 erstellt und zerstört der Threadpool Arbeitsthreads, um den Durchsatz zu optimieren. Der Durchsatz ist als die Anzahl der Aufgaben definiert, die pro Zeiteinheit abgeschlossen werden. Bei zu wenigen Threads werden die verfügbaren Ressourcen möglicherweise nicht optimal genutzt, wohingegen bei zu vielen Threads Ressourcenkonflikte auftreten können.

Sie können die GetMinThreads-Methode verwenden, um diese Mindestwerte abzurufen.

Eigenschaften

Methoden

Gilt für:

Threadsicherheit

Dieser Typ ist threadsicher.

Weitere Informationen

• Threads and Threading (Threads und Threading)
• Der verwaltete Threadpooling