SemaphoreSlim.WaitAsync Метод

Определение

Пространство имен:

System.Threading

Сборки:

netstandard.dll, System.Threading.dll

Асинхронно ожидает ввода SemaphoreSlim.

Перегрузки

Имя	Описание
WaitAsync(Int32, CancellationToken)	Асинхронно ожидает ввода SemaphoreSlim, используя 32-разрядное целое число со знаком для измерения интервала времени при наблюдении CancellationTokenза .
WaitAsync()	Асинхронно ожидает ввода SemaphoreSlim.
WaitAsync(Int32)	Асинхронно ожидает ввода SemaphoreSlim, используя 32-разрядное целое число со знаком для измерения интервала времени.
WaitAsync(CancellationToken)	Асинхронно ожидает ввода SemaphoreSlim, наблюдая за ней CancellationToken.
WaitAsync(TimeSpan)	Асинхронно ожидает ввода SemaphoreSlim, используя TimeSpan для измерения интервала времени.
WaitAsync(TimeSpan, CancellationToken)	Асинхронно ожидает ввода SemaphoreSlim, используя TimeSpan для измерения интервала времени, при наблюдении за ней CancellationToken.

WaitAsync(Int32, CancellationToken)

Исходный код:

SemaphoreSlim.cs

Асинхронно ожидает ввода SemaphoreSlim, используя 32-разрядное целое число со знаком для измерения интервала времени при наблюдении CancellationTokenза .

public:
 System::Threading::Tasks::Task<bool> ^ WaitAsync(int millisecondsTimeout, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<bool> WaitAsync(int millisecondsTimeout, System.Threading.CancellationToken cancellationToken);

member this.WaitAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Function WaitAsync (millisecondsTimeout As Integer, cancellationToken As CancellationToken) As Task(Of Boolean)

Параметры

millisecondsTimeout

Int32

Количество миллисекунд для ожидания (-1) для ожидания Infinite неопределенное время или ноль для проверки состояния дескриптора ожидания и возврата немедленно.

cancellationToken

CancellationToken

Наблюдаемые CancellationToken .

Возвращаемое значение

Task<Boolean>

Задача, которая завершится результатом true успешного ввода SemaphoreSlimтекущего потока, в противном случае — результатом false.

Исключения

ArgumentOutOfRangeException

millisecondsTimeout — это число, отличное от -1, которое представляет бесконечное время ожидания.

–или–

millisecondsTimeout больше int32.MaxValue.

ObjectDisposedException

Текущий экземпляр уже удален.

OperationCanceledException

cancellationToken отменено.

Комментарии

Если для времени ожидания задано значение -1 миллисекундах, метод ожидает неограниченное время ожидания.

Если время ожидания равно нулю миллисекундам, метод не блокируется. Он проверяет состояние дескриптора ожидания и возвращается немедленно.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Wait(Int32).

WaitAsync()

Исходный код:

SemaphoreSlim.cs

Асинхронно ожидает ввода SemaphoreSlim.

public:
 System::Threading::Tasks::Task ^ WaitAsync();

public System.Threading.Tasks.Task WaitAsync();

member this.WaitAsync : unit -> System.Threading.Tasks.Task

Public Function WaitAsync () As Task

Возвращаемое значение

Task

Задача, которая завершится после ввода семафора.

Исключения

ObjectDisposedException

Он SemaphoreSlim был удален.

Комментарии

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Wait().

WaitAsync(Int32)

Исходный код:

SemaphoreSlim.cs

Асинхронно ожидает ввода SemaphoreSlim, используя 32-разрядное целое число со знаком для измерения интервала времени.

public:
 System::Threading::Tasks::Task<bool> ^ WaitAsync(int millisecondsTimeout);

public System.Threading.Tasks.Task<bool> WaitAsync(int millisecondsTimeout);

member this.WaitAsync : int -> System.Threading.Tasks.Task<bool>

Public Function WaitAsync (millisecondsTimeout As Integer) As Task(Of Boolean)

Параметры

millisecondsTimeout

Int32

Количество миллисекунд для ожидания (-1) для ожидания Infinite неопределенное время или ноль для проверки состояния дескриптора ожидания и возврата немедленно.

Возвращаемое значение

Task<Boolean>

Задача, которая завершится результатом true успешного ввода SemaphoreSlimтекущего потока, в противном случае — результатом false.

Исключения

ObjectDisposedException

Текущий экземпляр уже удален.

ArgumentOutOfRangeException

millisecondsTimeout — отрицательное число, отличное от -1, которое представляет бесконечное время ожидания.

–или–

millisecondsTimeout больше int32.MaxValue.

Комментарии

Если для времени ожидания задано значение -1 миллисекундах, метод ожидает неограниченное время ожидания.

Если время ожидания равно нулю миллисекундам, метод не блокируется. Он проверяет состояние дескриптора ожидания и возвращается немедленно.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Wait(Int32).

WaitAsync(CancellationToken)

Исходный код:

SemaphoreSlim.cs

Асинхронно ожидает ввода SemaphoreSlim, наблюдая за ней CancellationToken.

public:
 System::Threading::Tasks::Task ^ WaitAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task WaitAsync(System.Threading.CancellationToken cancellationToken);

member this.WaitAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function WaitAsync (cancellationToken As CancellationToken) As Task

Параметры

cancellationToken

CancellationToken

Маркер CancellationToken для наблюдения.

Возвращаемое значение

Task

Задача, которая завершится после ввода семафора.

Исключения

ObjectDisposedException

Текущий экземпляр уже удален.

OperationCanceledException

cancellationToken отменено.

Комментарии

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Wait().

WaitAsync(TimeSpan)

Исходный код:

SemaphoreSlim.cs

Асинхронно ожидает ввода SemaphoreSlim, используя TimeSpan для измерения интервала времени.

public:
 System::Threading::Tasks::Task<bool> ^ WaitAsync(TimeSpan timeout);

public System.Threading.Tasks.Task<bool> WaitAsync(TimeSpan timeout);

member this.WaitAsync : TimeSpan -> System.Threading.Tasks.Task<bool>

Public Function WaitAsync (timeout As TimeSpan) As Task(Of Boolean)

Параметры

timeout

TimeSpan

Значение TimeSpan , TimeSpan представляющее количество миллисекунд, которое представляет -1 миллисекундах для ожидания на неопределенный срок или TimeSpan 0 миллисекунд для проверки дескриптора ожидания и возврата немедленно.

Возвращаемое значение

Task<Boolean>

Задача, которая завершится результатом true успешного ввода SemaphoreSlimтекущего потока, в противном случае — результатом false.

Исключения

ObjectDisposedException

Текущий экземпляр уже удален.

ArgumentOutOfRangeException

timeout — отрицательное число, отличное от -1, которое представляет бесконечное время ожидания.

–или–

В .NET 9 и более ранних версиях timeout больше , чем Int32.MaxValue.

Комментарии

Если для времени ожидания задано значение -1 миллисекундах, метод ожидает неограниченное время ожидания.

Если время ожидания равно нулю миллисекундам, метод не блокируется. Он проверяет состояние дескриптора ожидания и возвращается немедленно.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Wait(TimeSpan).

WaitAsync(TimeSpan, CancellationToken)

Исходный код:

SemaphoreSlim.cs

Асинхронно ожидает ввода SemaphoreSlim, используя TimeSpan для измерения интервала времени, при наблюдении за ней CancellationToken.

public:
 System::Threading::Tasks::Task<bool> ^ WaitAsync(TimeSpan timeout, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<bool> WaitAsync(TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

member this.WaitAsync : TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Function WaitAsync (timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of Boolean)

Параметры

timeout

TimeSpan

Значение TimeSpan , TimeSpan представляющее количество миллисекунд, которое представляет -1 миллисекундах для ожидания на неопределенный срок или TimeSpan 0 миллисекунд для проверки дескриптора ожидания и возврата немедленно.

cancellationToken

CancellationToken

Маркер CancellationToken для наблюдения.

Возвращаемое значение

Task<Boolean>

Задача, которая завершится результатом true успешного ввода SemaphoreSlimтекущего потока, в противном случае — результатом false.

Исключения

ArgumentOutOfRangeException

timeout — отрицательное число, отличное от -1, которое представляет бесконечное время ожидания.

–или–

В .NET 9 и более ранних версиях timeout больше , чем Int32.MaxValue.

OperationCanceledException

cancellationToken отменено.

ObjectDisposedException

Он SemaphoreSlim был удален.

Комментарии

Если для времени ожидания задано значение -1 миллисекундах, метод ожидает неограниченное время ожидания.

Если время ожидания равно нулю миллисекундам, метод не блокируется. Он проверяет состояние дескриптора ожидания и возвращается немедленно.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Wait(TimeSpan).