DataflowBlock.ReceiveAsync Метод

Ссылка

Определение

Пространство имен:: System.Threading.Tasks.Dataflow

Сборка:: System.Threading.Tasks.Dataflow.dll

Пакет:: System.Threading.Tasks.Dataflow v8.0.1

Пакет:: System.Threading.Tasks.Dataflow v9.0.0-rc.1.24431.7

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Перегрузки

ReceiveAsync<TOutput>(ISourceBlock<TOutput>)	Асинхронно получает значение от указанного источника.
ReceiveAsync<TOutput>(ISourceBlock<TOutput>, CancellationToken)	Асинхронно получает значение из указанного источника и предоставляет токен для отмены операции.
ReceiveAsync<TOutput>(ISourceBlock<TOutput>, TimeSpan)	Асинхронно получает значение из указанного источника, отслеживание необязательно точкой времени ожидания.
ReceiveAsync<TOutput>(ISourceBlock<TOutput>, TimeSpan, CancellationToken)	Асинхронно получает значение из указанного источника, обеспечивая токен для отмены операции за необязательным и интервал времени ожидания.

ReceiveAsync<TOutput>(ISourceBlock<TOutput>)

Исходный код:: DataflowBlock.cs

Исходный код:: DataflowBlock.cs

Исходный код:: DataflowBlock.cs

Асинхронно получает значение от указанного источника.

public:
generic <typename TOutput>
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task<TOutput> ^ ReceiveAsync(System::Threading::Tasks::Dataflow::ISourceBlock<TOutput> ^ source);

public static System.Threading.Tasks.Task<TOutput> ReceiveAsync<TOutput> (this System.Threading.Tasks.Dataflow.ISourceBlock<TOutput> source);

static member ReceiveAsync : System.Threading.Tasks.Dataflow.ISourceBlock<'Output> -> System.Threading.Tasks.Task<'Output>

<Extension()>
Public Function ReceiveAsync(Of TOutput) (source As ISourceBlock(Of TOutput)) As Task(Of TOutput)

Параметры типа

TOutput

Тип данных в источнике.

Параметры

source: ISourceBlock<TOutput>

Источник, от которого требуется получить значение.

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

Task<TOutput>

Задача, представляющая асинхронную операцию получения. При успешном получении значения от источника возвращаемая задача завершается и ее объект Result возвращает полученное значение. Если значение элемента невозможно извлечь, потому что источник пуст и завершен, создается исключение InvalidOperationException в возвращаемой задаче.

Исключения

ArgumentNullException

source имеет значение null.

Применяется к

ReceiveAsync<TOutput>(ISourceBlock<TOutput>, CancellationToken)

Исходный код:: DataflowBlock.cs

Исходный код:: DataflowBlock.cs

Исходный код:: DataflowBlock.cs

Асинхронно получает значение из указанного источника и предоставляет токен для отмены операции.

public:
generic <typename TOutput>
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task<TOutput> ^ ReceiveAsync(System::Threading::Tasks::Dataflow::ISourceBlock<TOutput> ^ source, System::Threading::CancellationToken cancellationToken);

public static System.Threading.Tasks.Task<TOutput> ReceiveAsync<TOutput> (this System.Threading.Tasks.Dataflow.ISourceBlock<TOutput> source, System.Threading.CancellationToken cancellationToken);

static member ReceiveAsync : System.Threading.Tasks.Dataflow.ISourceBlock<'Output> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Output>

<Extension()>
Public Function ReceiveAsync(Of TOutput) (source As ISourceBlock(Of TOutput), cancellationToken As CancellationToken) As Task(Of TOutput)

Параметры типа

TOutput

Указывает тип данных, содержащихся в источнике.

Параметры

source: ISourceBlock<TOutput>

Источник, от которого требуется получить значение.

cancellationToken: CancellationToken

Токен для отмены операции получения.

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

Task<TOutput>

Задача, представляющая асинхронную операцию получения. При успешном получении значения от источника возвращаемая задача завершается и ее объект Result возвращает полученное значение. Если значение невозможно извлечь, поскольку была запрошена отмена, возвращаемая задача отменена. Если значение невозможно извлечь, потому что источник пуст и завершен, создается исключение InvalidOperationException в возвращаемой задаче.

Исключения

ArgumentNullException

source имеет значение null.

OperationCanceledException

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Применяется к

ReceiveAsync<TOutput>(ISourceBlock<TOutput>, TimeSpan)

Исходный код:: DataflowBlock.cs

Исходный код:: DataflowBlock.cs

Исходный код:: DataflowBlock.cs

Асинхронно получает значение из указанного источника, отслеживание необязательно точкой времени ожидания.

public:
generic <typename TOutput>
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task<TOutput> ^ ReceiveAsync(System::Threading::Tasks::Dataflow::ISourceBlock<TOutput> ^ source, TimeSpan timeout);

public static System.Threading.Tasks.Task<TOutput> ReceiveAsync<TOutput> (this System.Threading.Tasks.Dataflow.ISourceBlock<TOutput> source, TimeSpan timeout);

static member ReceiveAsync : System.Threading.Tasks.Dataflow.ISourceBlock<'Output> * TimeSpan -> System.Threading.Tasks.Task<'Output>

<Extension()>
Public Function ReceiveAsync(Of TOutput) (source As ISourceBlock(Of TOutput), timeout As TimeSpan) As Task(Of TOutput)

Параметры типа

TOutput

Тип данных в источнике.

Параметры

source: ISourceBlock<TOutput>

Источник, от которого требуется получить значение.

timeout: TimeSpan

Максимальный временной интервал в миллисекундах ожидания завершения синхронной операции или интервал, представляющий -1 миллисекунду в случае неограниченного ожидания.

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

Task<TOutput>

Задача, представляющая асинхронную операцию получения. При успешном получении значения от источника возвращаемая задача завершается и ее объект Result возвращает полученное значение. Если значение невозможно извлечь, поскольку время ожидания истекло, возвращаемая задача отменена. Если значение невозможно извлечь, потому что источник пуст и завершен, создается исключение InvalidOperationException в возвращаемой задаче.

Исключения

ArgumentNullException

source имеет значение null.

ArgumentOutOfRangeException

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

-или-

timeout больше , чем Int32.MaxValue.

Применяется к

ReceiveAsync<TOutput>(ISourceBlock<TOutput>, TimeSpan, CancellationToken)

Исходный код:: DataflowBlock.cs

Исходный код:: DataflowBlock.cs

Исходный код:: DataflowBlock.cs

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

public:
generic <typename TOutput>
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task<TOutput> ^ ReceiveAsync(System::Threading::Tasks::Dataflow::ISourceBlock<TOutput> ^ source, TimeSpan timeout, System::Threading::CancellationToken cancellationToken);

public static System.Threading.Tasks.Task<TOutput> ReceiveAsync<TOutput> (this System.Threading.Tasks.Dataflow.ISourceBlock<TOutput> source, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

static member ReceiveAsync : System.Threading.Tasks.Dataflow.ISourceBlock<'Output> * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Output>

<Extension()>
Public Function ReceiveAsync(Of TOutput) (source As ISourceBlock(Of TOutput), timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of TOutput)

Параметры типа

TOutput

Тип данных в источнике.

Параметры

source: ISourceBlock<TOutput>

Источник, от которого требуется получить значение.

timeout: TimeSpan

cancellationToken: CancellationToken

Токен, который может быть использован для отмены операции получения.

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

Task<TOutput>

Задача, представляющая асинхронную операцию получения. При успешном получении значения от источника возвращаемая задача завершается и ее объект Result возвращает полученное значение. Если значение невозможно извлечь, поскольку истекло время ожидания отмены, возвращаемая задача отменена. Если значение нельзя извлечь, потому что источник пуст и завершен, создается исключение InvalidOperationException в возвращаемой задаче.

Исключения

ArgumentNullException

source имеет значение null.

ArgumentOutOfRangeException

-или-

timeout больше , чем Int32.MaxValue.

OperationCanceledException

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Применяется к

Поделиться через

DataflowBlock.ReceiveAsync Метод

Определение

Перегрузки

ReceiveAsync<TOutput>(ISourceBlock<TOutput>)

Параметры типа

Параметры

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

Исключения

Применяется к

ReceiveAsync<TOutput>(ISourceBlock<TOutput>, CancellationToken)

Параметры типа

Параметры

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

Исключения

Применяется к

ReceiveAsync<TOutput>(ISourceBlock<TOutput>, TimeSpan)

Параметры типа

Параметры

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

Исключения

Применяется к

ReceiveAsync<TOutput>(ISourceBlock<TOutput>, TimeSpan, CancellationToken)

Параметры типа

Параметры

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

Исключения

Применяется к

Дополнительные ресурсы