ThreadPool.SetMaxThreads(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

Define o número de solicitações para o pool de threads que podem estar ativas simultaneamente. Todas as solicitações acima desse número permanecem na fila até que os threads do pool de threads se tornem disponíveis.

public:
 static bool SetMaxThreads(int workerThreads, int completionPortThreads);
public static bool SetMaxThreads (int workerThreads, int completionPortThreads);
static member SetMaxThreads : int * int -> bool
Public Shared Function SetMaxThreads (workerThreads As Integer, completionPortThreads As Integer) As Boolean

Parâmetros

workerThreads
Int32

O número máximo de threads de trabalho no pool de threads.

completionPortThreads
Int32

O número máximo de threads de E/S assíncronas no pool de threads.

Retornos

Boolean

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

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.

Você não pode definir o número máximo de threads de trabalho ou threads de conclusão de E/S para um número menor que o número de processadores no computador. Para determinar quantos processadores estão presentes, recupere o valor da Environment.ProcessorCount propriedade . Além disso, você não pode definir o número máximo de threads de trabalho ou threads de conclusão de E/S para um número menor do que o número mínimo correspondente de threads de trabalho ou threads de conclusão de E/S. Para determinar o tamanho mínimo do pool de threads, chame o GetMinThreads método .

Se o common language runtime estiver hospedado, por exemplo, pelos Serviços de Informações da Internet (IIS) ou SQL Server, o host poderá limitar ou impedir alterações no tamanho do pool de threads.

Tenha cuidado ao alterar o número máximo de threads no pool de threads. Embora seu código possa se beneficiar, as alterações podem ter um efeito adverso nas bibliotecas de código que você usa.

Definir o tamanho do pool de threads muito grande pode causar problemas de desempenho. Se muitos threads estiverem sendo executados ao mesmo tempo, a sobrecarga de alternância de tarefa se tornará um fator significativo.

Observação

O pool de threads pode ter limites superiores para as contagens máximas de thread (como short.MaxValue, dependendo da implementação). Os valores de argumento são limitados ao limite superior, portanto, mesmo quando o método retorna true, as contagens de thread máximas reais podem ser menores do que as solicitadas.

Aplica-se a

Confira também