Task Класс

Определение

Пространство имен:
System.Threading.Tasks
Сборки:
mscorlib.dll, System.Threading.Tasks.dll
Сборка:
mscorlib.dll
Сборка:
System.Threading.Tasks.dll
Сборка:
netstandard.dll

Представляет асинхронную операцию.

public ref class Task : IAsyncResult
public ref class Task : IAsyncResult, IDisposable
public class Task : IAsyncResult
public class Task : IAsyncResult, IDisposable
type Task = class
    interface IAsyncResult
type Task = class
    interface IAsyncResult
    interface IDisposable
Public Class Task
Implements IAsyncResult
Public Class Task
Implements IAsyncResult, IDisposable
Наследование
Object
Task
Производный
Реализации
IAsyncResult IDisposable

Комментарии

Дополнительные сведения об этом API см. в дополнительных примечаниях API для задачи.

Конструкторы

Имя Описание
Task(Action, CancellationToken, TaskCreationOptions)

Инициализирует новый Task с указанными параметрами действия и создания.
Task(Action, CancellationToken)

Инициализирует новое Task с указанным действием и CancellationToken.
Task(Action, TaskCreationOptions)

Инициализирует новый Task с указанными параметрами действия и создания.
Task(Action)

Инициализирует новый Task с указанным действием.
Task(Action<Object>, Object, CancellationToken, TaskCreationOptions)

Инициализирует новый Task с указанным действием, состоянием и параметрами.
Task(Action<Object>, Object, CancellationToken)

Инициализирует новое Task с указанным действием, состоянием и CancellationToken.
Task(Action<Object>, Object, TaskCreationOptions)

Инициализирует новый Task с указанным действием, состоянием и параметрами.
Task(Action<Object>, Object)

Инициализирует новое Task с указанным действием и состоянием.

Свойства

Имя Описание
AsyncState

Возвращает объект состояния, предоставленный при Task создании, или значение NULL, если он не был предоставлен.
CompletedTask

Возвращает задачу, которая уже завершилась успешно.
CreationOptions

Возвращает используемый TaskCreationOptions для создания этой задачи.
CurrentId

Возвращает идентификатор выполняемого Taskв настоящее время.
Exception

Возвращает значение AggregateException , которое привело к преждевременному Task завершению. Task Если завершено успешно или еще не создано никаких исключений, возвращаетсяnull.
Factory

Предоставляет доступ к методам фабрики для создания и настройки Task экземпляров Task<TResult> .
Id

Возвращает идентификатор для этого Task экземпляра.
IsCanceled

Получает, завершилось ли выполнение этого Task экземпляра из-за отмены.
IsCompleted

Возвращает значение, указывающее, завершена ли задача.
IsCompletedSuccessfully

Возвращает, выполняется ли задача до завершения.
IsFaulted

Возвращает значение Task , выполненное из-за необработанного исключения.
Status

TaskStatus Возвращает эту задачу.

Методы

Имя Описание
ConfigureAwait(Boolean)

Настраивает средство ожидания, используемое для ожидания этого Task.
ContinueWith(Action<Task,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)

Создает продолжение, которое получает сведения о состоянии, предоставленное вызывающим абонентом, и маркер отмены, и выполняется после завершения целевого объекта Task . Продолжение выполняется на основе набора указанных условий и использует указанный планировщик.
ContinueWith(Action<Task,Object>, Object, CancellationToken)

Создает продолжение, которое получает сведения о состоянии, предоставленное вызывающим абонентом, и маркер отмены и выполняется асинхронно при завершении целевого объекта Task .
ContinueWith(Action<Task,Object>, Object, TaskContinuationOptions)

Создает продолжение, которое получает сведения о состоянии, предоставленное вызывающим пользователем, и выполняется после завершения целевого объекта Task . Продолжение выполняется на основе набора указанных условий.
ContinueWith(Action<Task,Object>, Object, TaskScheduler)

Создает продолжение, которое получает сведения о состоянии, предоставленное вызывающим пользователем, и выполняется асинхронно после завершения целевого объекта Task . Продолжение использует указанный планировщик.
ContinueWith(Action<Task,Object>, Object)

Создает продолжение, которое получает сведения о состоянии, предоставленное вызывающим пользователем, и выполняется после завершения целевого объекта Task .
ContinueWith(Action<Task>, CancellationToken, TaskContinuationOptions, TaskScheduler)

Создает продолжение, которое выполняется при конкуренции целевой задачи в соответствии с указанным TaskContinuationOptions. Продолжение получает маркер отмены и использует указанный планировщик.
ContinueWith(Action<Task>, CancellationToken)

Создает продолжение, которое получает маркер отмены и выполняется асинхронно после завершения целевого объекта Task .
ContinueWith(Action<Task>, TaskContinuationOptions)

Создает продолжение, которое выполняется, когда целевая задача завершается в соответствии с указанным TaskContinuationOptions.
ContinueWith(Action<Task>, TaskScheduler)

Создает продолжение, которое выполняется асинхронно при завершении целевого объекта Task . Продолжение использует указанный планировщик.
ContinueWith(Action<Task>)

Создает продолжение, которое выполняется асинхронно при завершении целевого объекта Task .
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)

Создает продолжение, которое выполняется на основе указанных параметров продолжения задачи, когда целевой объект Task завершается и возвращает значение. Продолжение получает сведения о состоянии, предоставленное вызывающим абонентом, и маркер отмены и использует указанный планировщик.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken)

Создает продолжение, которое выполняется асинхронно при завершении целевого объекта Task и возвращает значение. Продолжение получает сведения о состоянии, предоставленные вызывающим абонентом, и маркер отмены.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskContinuationOptions)

Создает продолжение, которое выполняется на основе указанных параметров продолжения задачи при завершении целевого объекта Task . Продолжение получает сведения о состоянии, предоставленные вызывающим абонентом.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskScheduler)

Создает продолжение, которое выполняется асинхронно при завершении целевого объекта Task . Продолжение получает сведения о состоянии, предоставленные вызывающим абонентом, и использует указанный планировщик.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object)

Создает продолжение, которое получает сведения о состоянии, предоставленное вызывающим абонентом, и выполняется асинхронно после завершения целевого объекта Task и возвращает значение.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)

Создает продолжение, которое выполняется в соответствии с указанными параметрами продолжения и возвращает значение. Продолжение передается маркер отмены и использует указанный планировщик.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken)

Создает продолжение, которое выполняется асинхронно при завершении целевого объекта Task и возвращает значение. Продолжение получает маркер отмены.
ContinueWith<TResult>(Func<Task,TResult>, TaskContinuationOptions)

Создает продолжение, которое выполняется в соответствии с указанными параметрами продолжения и возвращает значение.
ContinueWith<TResult>(Func<Task,TResult>, TaskScheduler)

Создает продолжение, которое выполняется асинхронно при завершении целевого объекта Task и возвращает значение. Продолжение использует указанный планировщик.
ContinueWith<TResult>(Func<Task,TResult>)

Создает продолжение, которое выполняется асинхронно при завершении целевого объекта Task<TResult> и возвращает значение.
Delay(Int32, CancellationToken)

Создает отмененную задачу, которая завершается после указанного числа миллисекунда.
Delay(Int32)

Создает задачу, которая завершается после указанного числа миллисекунда.
Delay(TimeSpan, CancellationToken)

Создает отмененную задачу, которая завершается после указанного интервала времени.
Delay(TimeSpan)

Создает задачу, которая завершается после указанного интервала времени.
Dispose()

Освобождает все ресурсы, используемые текущим экземпляром класса Task.
Dispose(Boolean)

TaskУдаляет все неуправляемые ресурсы.
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
FromCanceled(CancellationToken)

Создает завершенное Task из-за отмены с указанным маркером отмены.
FromCanceled<TResult>(CancellationToken)

Создает завершенное Task<TResult> из-за отмены с указанным маркером отмены.
FromException(Exception)

Создает объект, завершенный Task с указанным исключением.
FromException<TResult>(Exception)

Создает объект, завершенный Task<TResult> с указанным исключением.
FromResult<TResult>(TResult)

Создает успешно завершенное Task<TResult> действие с указанным результатом.
GetAwaiter()

Получает средство ожидания, используемое для ожидания этого Task.
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает Type текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()

Создает неглубокую копию текущей Object.

(Унаследовано от Object)
Run(Action, CancellationToken)

Очереди указанной работы, выполняемой Task в пуле потоков, и возвращает объект, представляющий работу. Маркер отмены позволяет отменить работу, если она еще не запущена.
Run(Action)

Очереди указанной работы, выполняемой Task в пуле потоков, и возвращает объект, представляющий работу.
Run(Func<Task>, CancellationToken)

Очереди указанной работы, выполняемой в пуле потоков, и возвращает прокси-сервер для задачи, возвращаемой function. Маркер отмены позволяет отменить работу, если она еще не запущена.
Run(Func<Task>)

Очереди указанной работы, выполняемой в пуле потоков, и возвращает прокси-сервер для задачи, возвращаемой function.
Run<TResult>(Func<Task<TResult>>, CancellationToken)

Очереди указанной работы, выполняемой в пуле потоков, и возвращает прокси-сервер для возвращаемого Task(TResult)function.
Run<TResult>(Func<Task<TResult>>)

Очереди указанной работы, выполняемой в пуле потоков, и возвращает прокси-сервер для возвращаемого Task(TResult)function. Маркер отмены позволяет отменить работу, если она еще не запущена.
Run<TResult>(Func<TResult>, CancellationToken)

Очереди указанной работы, выполняемой Task(TResult) в пуле потоков, и возвращает объект, представляющий работу.
Run<TResult>(Func<TResult>)

Очереди указанной работы, выполняемой Task<TResult> в пуле потоков, и возвращает объект, представляющий работу. Маркер отмены позволяет отменить работу, если она еще не запущена.
RunSynchronously()

Task Выполняется синхронно в текущемTaskScheduler.
RunSynchronously(TaskScheduler)

Task Выполняется синхронно на предоставленном объектеTaskScheduler.
Start()

TaskЗапускает , планируя его для выполнения в текущий TaskSchedulerмомент.
Start(TaskScheduler)

TaskЗапускает , планируя его для выполнения в указанныйTaskScheduler.
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)
Wait()

Task Ожидает завершения выполнения.
Wait(CancellationToken)

Task Ожидает завершения выполнения. Ожидание завершается, если маркер отмены отменен до завершения задачи.
Wait(Int32, CancellationToken)

Task Ожидает завершения выполнения. Ожидание завершается, если интервал времени ожидания истекает или маркер отмены отмены будет отменен до завершения задачи.
Wait(Int32)

Task Ожидает завершения выполнения в пределах указанного числа миллисекунда.
Wait(TimeSpan)

Task Ожидает завершения выполнения в течение указанного интервала времени.
WaitAll(Task[], CancellationToken)

Ожидает завершения выполнения всех предоставленных Task объектов, если ожидание не отменено.
WaitAll(Task[], Int32, CancellationToken)

Ожидает завершения выполнения всех предоставленных Task объектов в пределах указанного количества миллисекунда или до отмены ожидания.
WaitAll(Task[], Int32)

Ожидает завершения выполнения всех предоставленных Task объектов в пределах указанного числа миллисекунда.
WaitAll(Task[], TimeSpan)

Ожидает завершения выполнения всех предоставленных объектов с возможностью Task отмены в течение указанного интервала времени.
WaitAll(Task[])

Ожидает завершения выполнения всех предоставленных Task объектов.
WaitAny(Task[], CancellationToken)

Ожидает завершения выполнения любого из предоставленных Task объектов, если ожидание не отменено.
WaitAny(Task[], Int32, CancellationToken)

Ожидает завершения выполнения любого из предоставленных Task объектов в пределах указанного количества миллисекунда или до отмены маркера отмены.
WaitAny(Task[], Int32)

Ожидает завершения выполнения любого из предоставленных Task объектов в пределах указанного числа миллисекунда.
WaitAny(Task[], TimeSpan)

Ожидает завершения выполнения любого из предоставленных Task объектов в течение указанного интервала времени.
WaitAny(Task[])

Ожидает завершения выполнения любого из предоставленных Task объектов.
WhenAll(IEnumerable<Task>)

Создает задачу, которая завершится после завершения всех Task объектов в перечисленной коллекции.
WhenAll(Task[])

Создает задачу, которая завершится после завершения всех Task объектов в массиве.
WhenAll<TResult>(IEnumerable<Task<TResult>>)

Создает задачу, которая завершится после завершения всех Task<TResult> объектов в перечисленной коллекции.
WhenAll<TResult>(Task<TResult>[])

Создает задачу, которая завершится после завершения всех Task<TResult> объектов в массиве.
WhenAny(IEnumerable<Task>)

Создает задачу, которая завершится после завершения любой из предоставленных задач.
WhenAny(Task[])

Создает задачу, которая завершится после завершения любой из предоставленных задач.
WhenAny<TResult>(IEnumerable<Task<TResult>>)

Создает задачу, которая завершится после завершения любой из предоставленных задач.
WhenAny<TResult>(Task<TResult>[])

Создает задачу, которая завершится после завершения любой из предоставленных задач.
Yield()

Создает ожидаемую задачу, которая асинхронно возвращает текущий контекст при ожидании.

Явные реализации интерфейса

Имя Описание
IAsyncResult.AsyncWaitHandle

Получает значение WaitHandle , которое можно использовать для ожидания завершения задачи.
IAsyncResult.CompletedSynchronously

Получает указание на то, выполняется ли операция синхронно.

Методы расширения

Имя Описание
AsAsyncAction(Task)

Возвращает асинхронное действие среды выполнения Windows, представляющее запущенную задачу.
DispatcherOperationWait(Task, TimeSpan)

Ожидает завершения указанного периода времени DispatcherOperation .
DispatcherOperationWait(Task)

Ожидает бесконечного завершения базовой DispatcherOperation базы данных.
IsDispatcherOperationTask(Task)

Возвращает значение, указывающее, связана ли эта Task функция с DispatcherOperation.

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

Потокобезопасность

Все члены Task, за исключением Dispose(), являются потокобезопасными и могут использоваться из нескольких потоков одновременно.

См. также раздел