ThreadPool.SetMinThreads(Int32, Int32) Método

Referência

Definição

Namespace:: System.Threading

Assembly:: System.Threading.ThreadPool.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Origem:: ThreadPool.CoreCLR.cs

Origem:: ThreadPool.Unix.cs

Origem:: ThreadPool.Unix.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Define o número mínimo de threads que o pool de threads cria sob demanda à medida que novas solicitações são feitas, antes de mudar para um algoritmo a fim de gerenciar a criação e a destruição de thread.

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

Parâmetros

workerThreads: Int32

O número mínimo de threads de trabalho que o pool de threads cria sob demanda.

completionPortThreads: Int32

O número mínimo de threads de E/S assíncronos que o pool de threads cria sob demanda.

Retornos

Boolean

true se a alteração for bem-sucedida; caso contrário, false.

Exemplos

O exemplo a seguir define o número mínimo de threads de trabalho como quatro e preserva o valor original para o número mínimo de threads de conclusão de E/S assíncronos.

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

Comentários

Não há suporte para esse método quando o pool de threads do Windows está configurado para ser usado em vez do pool de threads do .NET. Para obter mais informações, consulte a configuração do pool de threads do Windows.

O pool de threads fornece novos threads de trabalho ou threads de conclusão de E/S sob demanda até atingir o mínimo para cada categoria. Quando o mínimo é atingido, o pool de threads pode criar threads adicionais nessa categoria ou aguardar até que algumas tarefas sejam concluídas. A partir do .NET Framework 4, o pool de threads cria e destrói threads para otimizar a taxa de transferência, que é definida como o número de tarefas concluídas por unidade de tempo. Pouquíssimos threads podem não fazer um uso ideal dos recursos disponíveis, enquanto muitos threads podem aumentar a contenção de recursos.

Quando a demanda é baixa, o número real de threads do pool de threads pode ficar abaixo dos valores mínimos.

Se você especificar um número negativo ou um número maior que o número máximo de threads de pool de threads ativos (obtidos usando GetMaxThreads), SetMinThreads retornará false e não alterará nenhum dos valores mínimos.

Por padrão, o número mínimo de threads é definido como a contagem de processadores. Você pode usar SetMinThreads para aumentar o número mínimo de threads, como para contornar temporariamente problemas em que alguns itens de trabalho enfileirados ou tarefas bloqueiam threads do pool de threads. Esses bloqueios às vezes levam a uma situação em que todos os threads de conclusão de E/S ou de trabalho são bloqueados (fome). No entanto, aumentar o número mínimo de threads pode prejudicar o desempenho de outras maneiras, como:

O pool de threads pode agendar mais threads de trabalho, mesmo quando os threads de trabalho não estão sendo bloqueados. A sobrescrição pode fazer com que os threads agendados sejam significativamente atrasados à medida que esperam em uma fila longa para obter outra fatia de tempo, atrasando alguns itens de trabalho ou tarefas.
Os threads de trabalho podem levar mais tempo de CPU na remoção de itens de trabalho devido à necessidade de verificar mais threads para roubar o trabalho.
A alternância de contexto entre threads pode aumentar o uso da CPU.
A coleta de lixo pode levar mais tempo de CPU no andamento da pilha de threads.
O processo pode consumir mais memória.

Cuidado

Usar o SetMinThreads método para aumentar o número mínimo de threads pode causar problemas de desempenho, conforme descrito no texto anterior. Na maioria dos casos, o pool de threads terá um desempenho melhor com seu próprio algoritmo para alocar threads. Reduzir o mínimo para menos do que o número de processadores também pode prejudicar o desempenho.

Aplica-se a

Partilhar via