ThreadPool.SetMinThreads(Int32, Int32) Méthode

Définition

Espace de noms:
System.Threading
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Définit le nombre minimal de threads créés par le pool de threads à la demande, à mesure que de nouvelles demandes sont effectuées, avant de passer à un algorithme pour gérer la création et la destruction des threads.

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

Paramètres

workerThreads
Int32

Nombre minimal de threads de travail créés par le pool de threads à la demande.

completionPortThreads
Int32

Nombre minimal de threads d’E/S asynchrones que le pool de threads crée à la demande.

Retours

Boolean

true si la modification réussit ; sinon, false.

Exemples

L’exemple suivant définit le nombre minimal de threads de travail sur quatre et conserve la valeur d’origine pour le nombre minimal de threads d’achèvement d’E/S asynchrones.

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

Remarques

Cette méthode n’est pas prise en charge lorsque le pool de threads Windows est configuré pour être utilisé au lieu du pool de threads .NET. Pour plus d’informations, consultez le paramètre de configuration du pool de threads Windows.

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 minimum pour chaque catégorie. Lorsque le minimum 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 du .NET Framework 4, le pool de threads crée et détruit les threads 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.

Quand la demande est faible, le nombre réel de threads du pool peut être inférieur aux valeurs minimales.

Si vous spécifiez un nombre négatif ou un nombre supérieur au nombre maximal de threads de pool de threads actifs (obtenus à l’aide GetMaxThreadsde ), SetMinThreads retourne false et ne modifie pas l’une des valeurs minimales.

Par défaut, le nombre minimum de threads est défini sur le nombre de processeurs. Vous pouvez utiliser SetMinThreads pour augmenter le nombre minimum de threads, par exemple pour contourner temporairement des problèmes où certains éléments de travail ou tâches en file d’attente bloquent les threads du pool de threads. Ces blocages conduisent parfois à une situation où tous les threads de travail ou d’achèvement d’E/S sont bloqués (privation). Toutefois, l’augmentation du nombre minimal de threads peut dégrader les performances d’autres façons, telles que :

  • Le pool de threads peut planifier davantage de threads de travail, même lorsque les threads de travail ne sont pas bloqués. Le sursubscription peut entraîner un retard considérable des threads qui sont planifiés, car ils attendent dans une longue file d’attente pour obtenir une autre tranche de temps, en retardant certains éléments de travail ou tâches.
  • Les threads de travail peuvent prendre plus de temps processeur dans la suppression des éléments de travail en raison d’avoir à analyser plus de threads pour voler le travail.
  • Le basculement de contexte entre les threads peut augmenter l’utilisation du processeur.
  • Le garbage collection peut prendre plus de temps processeur dans la marche à pied de la pile de threads.
  • Le processus peut consommer plus de mémoire.

Avertissement

L’utilisation de la SetMinThreads méthode pour augmenter le nombre minimal de threads peut entraîner des problèmes de performances, comme décrit dans le texte précédent. Dans la plupart des cas, le pool de threads s’effectue mieux avec son propre algorithme pour allouer des threads. Réduire le minimum à moins que le nombre de processeurs peut également nuire aux performances.

S’applique à

Voir aussi