SemaphoreSlim.Wait Método

Definição

Namespace:

System.Threading

Assemblies:

netstandard.dll, System.Threading.dll

Bloqueia o thread atual até que ele possa inserir o SemaphoreSlim.

Sobrecargas

Nome	Description
Wait(TimeSpan, CancellationToken)	Bloqueia o thread atual até que ele possa inserir o SemaphoreSlim, usando um TimeSpan que especifica o tempo limite, enquanto observa um CancellationToken.
Wait(Int32, CancellationToken)	Bloqueia o thread atual até que ele possa inserir o SemaphoreSliminteiro com sinal de 32 bits que especifica o tempo limite, enquanto observa um CancellationToken.
Wait(TimeSpan)	Bloqueia o thread atual até que ele possa inserir o SemaphoreSlim, usando um TimeSpan para especificar o tempo limite.
Wait(Int32)	Bloqueia o thread atual até que ele possa inserir o SemaphoreSliminteiro com sinal de 32 bits que especifica o tempo limite.
Wait()	Bloqueia o thread atual até que ele possa inserir o SemaphoreSlim.
Wait(CancellationToken)	Bloqueia o thread atual até que ele possa inserir o SemaphoreSlim, enquanto observa um CancellationToken.

Wait(TimeSpan, CancellationToken)

Origem:

SemaphoreSlim.cs

Bloqueia o thread atual até que ele possa inserir o SemaphoreSlim, usando um TimeSpan que especifica o tempo limite, enquanto observa um CancellationToken.

public:
 bool Wait(TimeSpan timeout, System::Threading::CancellationToken cancellationToken);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public bool Wait(TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.Wait : TimeSpan * System.Threading.CancellationToken -> bool

Public Function Wait (timeout As TimeSpan, cancellationToken As CancellationToken) As Boolean

Parâmetros

timeout

TimeSpan

Um TimeSpan que representa o número de milissegundos a aguardar, um TimeSpan que representa -1 milissegundos para esperar indefinidamente ou um TimeSpan que representa 0 milissegundos para testar o identificador de espera e retornar imediatamente.

cancellationToken

CancellationToken

O CancellationToken que observar.

Retornos

Boolean

true se o thread atual tiver inserido com êxito; SemaphoreSlimcaso contrário, false.

Atributos

UnsupportedOSPlatformAttribute

Exceções

OperationCanceledException

cancellationToken foi cancelado.

ArgumentOutOfRangeException

timeout é um número negativo diferente de -1, que representa um tempo limite infinito.

-ou-

No .NET 9 e versões anteriores, timeout é maior que Int32.MaxValue.

ObjectDisposedException

A instância do semaphoreSlim foi descartada.

-ou-

O CancellationTokenSource que foi criado cancellationToken já foi descartado.

Comentários

Se o tempo limite estiver definido como -1 milissegundos, o método aguardará indefinidamente.

Se o tempo limite for definido como zero milissegundos, o método não será bloqueado. Ele testa o estado do identificador de espera e retorna imediatamente.

Se um thread ou tarefa for capaz de inserir o semáforo, ele diminuirá a CurrentCount propriedade por um.

Se cancellationToken for cancelado ou se um thread ou tarefa for bloqueado ao chamar Wait(TimeSpan, CancellationToken) e o intervalo de tempo limite especificado por millisecondsTimeout expiração:

• O thread ou tarefa não insere o semáforo.
• A CurrentCount propriedade não é decrementada.

Se cancellationToken for cancelado, o método gerará uma exceção OperationCanceledException .

Confira também

• Semáforo e SemaphoreSlim
• Cancelamento

Wait(Int32, CancellationToken)

Origem:

SemaphoreSlim.cs

Bloqueia o thread atual até que ele possa inserir o SemaphoreSliminteiro com sinal de 32 bits que especifica o tempo limite, enquanto observa um CancellationToken.

public:
 bool Wait(int millisecondsTimeout, System::Threading::CancellationToken cancellationToken);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public bool Wait(int millisecondsTimeout, System.Threading.CancellationToken cancellationToken);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.Wait : int * System.Threading.CancellationToken -> bool

Public Function Wait (millisecondsTimeout As Integer, cancellationToken As CancellationToken) As Boolean

Parâmetros

millisecondsTimeout

Int32

O número de milissegundos a aguardar, Infinite (-1) para aguardar indefinidamente ou zero para testar o estado do identificador de espera e retornar imediatamente.

cancellationToken

CancellationToken

O CancellationToken que observar.

Retornos

Boolean

true se o thread atual tiver inserido com êxito; SemaphoreSlimcaso contrário, false.

Atributos

UnsupportedOSPlatformAttribute

Exceções

OperationCanceledException

cancellationToken foi cancelado.

ArgumentOutOfRangeException

millisecondsTimeout é um número negativo diferente de -1, que representa um tempo limite infinito.

-ou-

millisecondsTimeout é maior que Int32.MaxValue.

ObjectDisposedException

A SemaphoreSlim instância foi descartada ou a CancellationTokenSource que foi criada cancellationToken foi descartada.

Comentários

Se o tempo limite estiver definido como -1 milissegundos, o método aguardará indefinidamente.

Se o tempo limite for definido como zero milissegundos, o método não será bloqueado. Ele testa o estado do identificador de espera e retorna imediatamente.

Se um thread ou tarefa for capaz de inserir o semáforo, ele diminuirá a CurrentCount propriedade por um.

Se cancellationToken for cancelado ou se um thread ou tarefa for bloqueado ao chamar Wait(Int32, CancellationToken) e o intervalo de tempo limite especificado por millisecondsTimeout expiração:

• O thread ou tarefa não insere o semáforo.
• A CurrentCount propriedade não é decrementada.

Se cancellationToken for cancelado, o método gerará uma exceção OperationCanceledException .

Confira também

• Semáforo e SemaphoreSlim

Wait(TimeSpan)

Origem:

SemaphoreSlim.cs

Bloqueia o thread atual até que ele possa inserir o SemaphoreSlim, usando um TimeSpan para especificar o tempo limite.

public:
 bool Wait(TimeSpan timeout);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public bool Wait(TimeSpan timeout);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.Wait : TimeSpan -> bool

Public Function Wait (timeout As TimeSpan) As Boolean

Parâmetros

timeout

TimeSpan

Um TimeSpan que representa o número de milissegundos a aguardar, um TimeSpan que representa -1 milissegundos para esperar indefinidamente ou um TimeSpan que representa 0 milissegundos para testar o identificador de espera e retornar imediatamente.

Retornos

Boolean

true se o thread atual tiver inserido com êxito; SemaphoreSlimcaso contrário, false.

Atributos

UnsupportedOSPlatformAttribute

Exceções

ArgumentOutOfRangeException

timeout é um número negativo diferente de -1, que representa um tempo limite infinito.

-ou-

No .NET 9 e versões anteriores, timeout é maior que Int32.MaxValue.

ObjectDisposedException

A instância do semaphoreSlim foi descartada.

Comentários

Se o tempo limite estiver definido como -1 milissegundos, o método aguardará indefinidamente.

Se o tempo limite for definido como zero milissegundos, o método não será bloqueado. Ele testa o estado do identificador de espera e retorna imediatamente.

Se um thread ou tarefa for capaz de inserir o semáforo, ele diminuirá a CurrentCount propriedade por um.

Se um thread ou tarefa for bloqueado ao chamar Wait(TimeSpan) e o intervalo de tempo limite especificado por millisecondsTimeout expiração:

• O thread ou tarefa não insere o semáforo.
• A CurrentCount propriedade não é decrementada.

Confira também

• Semáforo e SemaphoreSlim

Wait(Int32)

Origem:

SemaphoreSlim.cs

Bloqueia o thread atual até que ele possa inserir o SemaphoreSliminteiro com sinal de 32 bits que especifica o tempo limite.

public:
 bool Wait(int millisecondsTimeout);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public bool Wait(int millisecondsTimeout);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.Wait : int -> bool

Public Function Wait (millisecondsTimeout As Integer) As Boolean

Parâmetros

millisecondsTimeout

Int32

O número de milissegundos a aguardar, Infinite (-1) para aguardar indefinidamente ou zero para testar o estado do identificador de espera e retornar imediatamente.

Retornos

Boolean

true se o thread atual tiver inserido com êxito; SemaphoreSlimcaso contrário, false.

Atributos

UnsupportedOSPlatformAttribute

Exceções

ArgumentOutOfRangeException

millisecondsTimeout é um número negativo diferente de -1, que representa um tempo limite infinito -ou- tempo limite é maior que Int32.MaxValue.

ObjectDisposedException

O SemaphoreSlim foi descartado.

Comentários

Se o tempo limite estiver definido como -1 milissegundos, o método aguardará indefinidamente.

Se o tempo limite for definido como zero milissegundos, o método não será bloqueado. Ele testa o estado do identificador de espera e retorna imediatamente.

Se um thread ou tarefa for capaz de inserir o semáforo, ele diminuirá a CurrentCount propriedade por um.

Se um thread ou tarefa for bloqueado ao chamar Wait(Int32) e o intervalo de tempo limite especificado por millisecondsTimeout expiração:

• O thread ou tarefa não insere o semáforo.
• A CurrentCount propriedade não é decrementada.

Confira também

• Semáforo e SemaphoreSlim

Wait()

Origem:

SemaphoreSlim.cs

Bloqueia o thread atual até que ele possa inserir o SemaphoreSlim.

public:
 void Wait();

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public void Wait();

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.Wait : unit -> unit

Public Sub Wait ()

Atributos

UnsupportedOSPlatformAttribute

Exceções

ObjectDisposedException

A instância atual já foi descartada.

Comentários

Se um thread ou tarefa for capaz de inserir o semáforo, ele diminuirá a CurrentCount propriedade por um.

Confira também

• Semáforo e SemaphoreSlim

Wait(CancellationToken)

Origem:

SemaphoreSlim.cs

Bloqueia o thread atual até que ele possa inserir o SemaphoreSlim, enquanto observa um CancellationToken.

public:
 void Wait(System::Threading::CancellationToken cancellationToken);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public void Wait(System.Threading.CancellationToken cancellationToken);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.Wait : System.Threading.CancellationToken -> unit

Public Sub Wait (cancellationToken As CancellationToken)

Parâmetros

cancellationToken

CancellationToken

O CancellationToken token a ser observado.

Atributos

UnsupportedOSPlatformAttribute

Exceções

OperationCanceledException

cancellationToken foi cancelado.

ObjectDisposedException

A instância atual já foi descartada.

-ou-

O CancellationTokenSource que foi criado cancellationToken já foi descartado.

Comentários

Se um thread ou tarefa for capaz de inserir o semáforo, ele diminuirá a CurrentCount propriedade por um.

Se cancellationToken for cancelado, o thread ou a tarefa não inserirá o semáforo e a CurrentCount propriedade não será decrementada. Em vez disso, o método gera uma exceção OperationCanceledException .

Confira também

• Semáforo e SemaphoreSlim
• Cancelamento