ThreadPool.SetMinThreads(Int32, Int32) Metoda

Definicja

Przestrzeń nazw:

System.Threading

Zestaw:

System.Threading.ThreadPool.dll

Źródło:

ThreadPool.Unix.cs

Ustawia minimalną liczbę wątków tworzonych przez pulę wątków na żądanie, ponieważ są wykonywane nowe żądania, przed przełączeniem do algorytmu zarządzania tworzeniem i niszczeniem wątków.

public:
 static bool SetMinThreads(int workerThreads, int completionPortThreads);

public static bool SetMinThreads (int workerThreads, int completionPortThreads);

static member SetMinThreads : int * int -> bool

Public Shared Function SetMinThreads (workerThreads As Integer, completionPortThreads As Integer) As Boolean

Parametry

workerThreads

Int32

Minimalna liczba wątków roboczych tworzonych przez pulę wątków na żądanie.

completionPortThreads

Int32

Minimalna liczba asynchronicznych wątków we/wy tworzonych na żądanie przez pulę wątków.

Zwraca

Boolean

true jeśli zmiana zakończy się pomyślnie; w przeciwnym razie , false.

Przykłady

Poniższy przykład ustawia minimalną liczbę wątków roboczych na cztery i zachowuje oryginalną wartość minimalnej liczby asynchronicznych wątków uzupełniania we/wy.

using namespace System;
using namespace System::Threading;
int main()
{
   int minWorker;
   int minIOC;
   
   // Get the current settings.
   ThreadPool::GetMinThreads( minWorker, minIOC );
   
   // Change the minimum number of worker threads to four, but
   // keep the old setting for minimum asynchronous I/O
   // completion threads.
   if ( ThreadPool::SetMinThreads( 4, minIOC ) )
   {
      
      // The minimum number of threads was set successfully.
   }
   else
   {
      
      // The minimum number of threads was not changed.
   }
}

using System;
using System.Threading;

public class Test
{
    public static void Main()
    {
        int minWorker, minIOC;
        // Get the current settings.
        ThreadPool.GetMinThreads(out minWorker, out minIOC);
        // Change the minimum number of worker threads to four, but
        // keep the old setting for minimum asynchronous I/O 
        // completion threads.
        if (ThreadPool.SetMinThreads(4, minIOC))
        {
            // The minimum number of threads was set successfully.
        }
        else
        {
            // The minimum number of threads was not changed.
        }
    }
}

Imports System.Threading

Public Class Test

    <MTAThread> _
    Public Shared Sub Main()
        Dim minWorker, minIOC As Integer
        ' Get the current settings.
        ThreadPool.GetMinThreads(minWorker, minIOC)
        ' Change the minimum number of worker threads to four, but
        ' keep the old setting for minimum asynchronous I/O 
        ' completion threads.
        If ThreadPool.SetMinThreads(4, minIOC) Then
            ' The minimum number of threads was set successfully.
        Else
            ' The minimum number of threads was not changed.
        End If
    End Sub
End Class

Uwagi

Ta metoda nie jest obsługiwana, gdy pula wątków systemu Windows jest skonfigurowana do użycia zamiast puli wątków platformy .NET. Aby uzyskać więcej informacji, zobacz ustawienie konfiguracji puli wątków systemu Windows.

Pula wątków udostępnia nowe wątki robocze lub wątki uzupełniania we/wy na żądanie do momentu osiągnięcia minimum dla każdej kategorii. Po osiągnięciu minimum pula wątków może utworzyć dodatkowe wątki w tej kategorii lub poczekać na ukończenie niektórych zadań. Począwszy od programu .NET Framework 4, pula wątków tworzy i niszczy wątki w celu zoptymalizowania przepływności, która jest definiowana jako liczba zadań wykonywanych na jednostkę czasu. Zbyt mało wątków może nie zapewnić optymalnego wykorzystania dostępnych zasobów, podczas gdy zbyt wiele wątków może zwiększyć rywalizację o zasoby.

Gdy zapotrzebowanie jest niskie, rzeczywista liczba wątków puli wątków może spaść poniżej minimalnych wartości.

Jeśli określisz liczbę ujemną lub liczbę większą niż maksymalna liczba wątków aktywnych wątków (uzyskanych przy użyciu metody GetMaxThreads), SetMinThreads zwraca false wartość i nie zmienia żadnej z wartości minimalnych.

Domyślnie minimalna liczba wątków jest ustawiana na liczbę procesorów. Można użyć SetMinThreads do zwiększenia minimalnej liczby wątków, takich jak tymczasowe obejście problemów, w których niektóre elementy robocze w kolejce lub zadania blokują wątki puli wątków. Te blokady czasami prowadzą do sytuacji, w której wszystkie wątki ukończenia procesu roboczego lub we/wy są blokowane (głodowanie). Jednak zwiększenie minimalnej liczby wątków może obniżyć wydajność w inny sposób, na przykład:

• Pula wątków może zaplanować więcej wątków roboczych, nawet jeśli wątki robocze nie są blokowane. Zasubskrypcja może spowodować, że wątki, które mają być znacznie opóźnione, ponieważ oczekują w długiej kolejce, aby uzyskać inny fragment czasu, opóźniając niektóre elementy robocze lub zadania.
• Wątki procesów roboczych mogą zająć więcej czasu na kolejkowanie elementów roboczych z powodu konieczności skanowania większej liczby wątków w celu kradzieży pracy.
• Przełączanie kontekstu między wątkami może zwiększyć użycie procesora CPU.
• Odzyskiwanie pamięci może potrwać więcej czasu procesora CPU w stosie wątków.
• Proces może zużywać więcej pamięci.

Przestroga

SetMinThreads Użycie metody w celu zwiększenia minimalnej liczby wątków może powodować problemy z wydajnością zgodnie z opisem w poprzednim tekście. W większości przypadków pula wątków będzie działać lepiej przy użyciu własnego algorytmu przydzielania wątków. Zmniejszenie minimum do mniejszej niż liczba procesorów może również zaszkodzić wydajności.

Zobacz też

• GetMinThreads(Int32, Int32)
• GetMaxThreads(Int32, Int32)
• GetAvailableThreads(Int32, Int32)