Task Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa una operación asincrónica.
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
- Herencia
-
Task
- Derivado
- Implementaciones
Comentarios
Para obtener más información sobre esta API, consulte comentarios de API complementarias para Task.
Constructores
Task(Action) |
Inicializa un nuevo Task con la acción especificada. |
Task(Action, CancellationToken) |
Inicializa un nuevo Task con la acción especificada y CancellationToken. |
Task(Action, CancellationToken, TaskCreationOptions) |
Inicializa un nuevo Task con las opciones de acción y creación especificadas. |
Task(Action, TaskCreationOptions) |
Inicializa un nuevo Task con las opciones de acción y creación especificadas. |
Task(Action<Object>, Object) |
Inicializa un nuevo Task con la acción y el estado especificados. |
Task(Action<Object>, Object, CancellationToken) |
Inicializa un nuevo Task con la acción, el estado y CancellationTokenespecificados. |
Task(Action<Object>, Object, CancellationToken, TaskCreationOptions) |
Inicializa un nuevo Task con la acción, el estado y las opciones especificados. |
Task(Action<Object>, Object, TaskCreationOptions) |
Inicializa un nuevo Task con la acción, el estado y las opciones especificados. |
Propiedades
AsyncState |
Obtiene el objeto de estado proporcionado cuando se creó el Task, o null si no se proporcionó ninguno. |
CompletedTask |
Obtiene una tarea que ya se ha completado correctamente. |
CreationOptions |
Obtiene el TaskCreationOptions usado para crear esta tarea. |
CurrentId |
Devuelve el identificador del Taskque se está ejecutando actualmente. |
Exception |
Obtiene el AggregateException que provocó que el Task finalizara prematuramente. Si el Task se completó correctamente o aún no ha producido ninguna excepción, devolverá |
Factory |
Proporciona acceso a los métodos de fábrica para crear y configurar instancias de Task y Task<TResult>. |
Id |
Obtiene un identificador para esta instancia de Task. |
IsCanceled |
Obtiene si esta instancia de Task ha completado la ejecución debido a la cancelación. |
IsCompleted |
Obtiene un valor que indica si la tarea se ha completado. |
IsCompletedSuccessfully |
Obtiene si la tarea se ejecutó hasta la finalización. |
IsFaulted |
Obtiene si el Task completado debido a una excepción no controlada. |
Status |
Obtiene el TaskStatus de esta tarea. |
Métodos
ConfigureAwait(Boolean) |
Configura un awaiter usado para esperar este Task. |
ConfigureAwait(ConfigureAwaitOptions) |
Configura un awaiter usado para esperar este Task. |
ContinueWith(Action<Task,Object>, Object) |
Crea una continuación que recibe información de estado proporcionada por el autor de la llamada y se ejecuta cuando se completa el destino Task. |
ContinueWith(Action<Task,Object>, Object, CancellationToken) |
Crea una continuación que recibe información de estado proporcionada por el autor de la llamada y un token de cancelación y que se ejecuta de forma asincrónica cuando se completa el Task de destino. |
ContinueWith(Action<Task,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler) |
Crea una continuación que recibe información de estado proporcionada por el autor de la llamada y un token de cancelación y que se ejecuta cuando se completa el Task de destino. La continuación se ejecuta en función de un conjunto de condiciones especificadas y usa un programador especificado. |
ContinueWith(Action<Task,Object>, Object, TaskContinuationOptions) |
Crea una continuación que recibe información de estado proporcionada por el autor de la llamada y se ejecuta cuando se completa el destino Task. La continuación se ejecuta en función de un conjunto de condiciones especificadas. |
ContinueWith(Action<Task,Object>, Object, TaskScheduler) |
Crea una continuación que recibe información de estado proporcionada por el autor de la llamada y se ejecuta de forma asincrónica cuando se completa el destino Task. La continuación usa un programador especificado. |
ContinueWith(Action<Task>) |
Crea una continuación que se ejecuta de forma asincrónica cuando se completa el Task de destino. |
ContinueWith(Action<Task>, CancellationToken) |
Crea una continuación que recibe un token de cancelación y se ejecuta de forma asincrónica cuando se completa el Task de destino. |
ContinueWith(Action<Task>, CancellationToken, TaskContinuationOptions, TaskScheduler) |
Crea una continuación que se ejecuta cuando la tarea de destino compite según el TaskContinuationOptionsespecificado. La continuación recibe un token de cancelación y usa un programador especificado. |
ContinueWith(Action<Task>, TaskContinuationOptions) |
Crea una continuación que se ejecuta cuando se completa la tarea de destino según el TaskContinuationOptionsespecificado. |
ContinueWith(Action<Task>, TaskScheduler) |
Crea una continuación que se ejecuta de forma asincrónica cuando se completa el Task de destino. La continuación usa un programador especificado. |
ContinueWith<TResult>(Func<Task,Object,TResult>, Object) |
Crea una continuación que recibe información de estado proporcionada por el autor de la llamada y se ejecuta de forma asincrónica cuando el destino Task finaliza y devuelve un valor. |
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken) |
Crea una continuación que se ejecuta de forma asincrónica cuando el destino Task completa y devuelve un valor. La continuación recibe información de estado proporcionada por el autor de la llamada y un token de cancelación. |
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler) |
Crea una continuación que se ejecuta en función de las opciones de continuación de tareas especificadas cuando el destino Task completa y devuelve un valor. La continuación recibe información de estado proporcionada por el autor de la llamada y un token de cancelación y usa el programador especificado. |
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskContinuationOptions) |
Crea una continuación que se ejecuta en función de las opciones de continuación de tareas especificadas cuando se completa el destino Task. La continuación recibe información de estado proporcionada por el autor de la llamada. |
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskScheduler) |
Crea una continuación que se ejecuta de forma asincrónica cuando se completa el Task de destino. La continuación recibe información de estado proporcionada por el autor de la llamada y usa un programador especificado. |
ContinueWith<TResult>(Func<Task,TResult>) |
Crea una continuación que se ejecuta de forma asincrónica cuando el destino Task<TResult> completa y devuelve un valor. |
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken) |
Crea una continuación que se ejecuta de forma asincrónica cuando el destino Task completa y devuelve un valor. La continuación recibe un token de cancelación. |
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler) |
Crea una continuación que se ejecuta según las opciones de continuación especificadas y devuelve un valor. La continuación se pasa un token de cancelación y usa un programador especificado. |
ContinueWith<TResult>(Func<Task,TResult>, TaskContinuationOptions) |
Crea una continuación que se ejecuta según las opciones de continuación especificadas y devuelve un valor. |
ContinueWith<TResult>(Func<Task,TResult>, TaskScheduler) |
Crea una continuación que se ejecuta de forma asincrónica cuando el destino Task completa y devuelve un valor. La continuación usa un programador especificado. |
Delay(Int32) |
Crea una tarea que se completa después de un número especificado de milisegundos. |
Delay(Int32, CancellationToken) |
Crea una tarea cancelable que se completa después de un número especificado de milisegundos. |
Delay(TimeSpan) |
Crea una tarea que se completa después de un intervalo de tiempo especificado. |
Delay(TimeSpan, CancellationToken) |
Crea una tarea cancelable que se completa después de un intervalo de tiempo especificado. |
Delay(TimeSpan, TimeProvider) |
Crea una tarea que se completa después de un intervalo de tiempo especificado. |
Delay(TimeSpan, TimeProvider, CancellationToken) |
Crea una tarea cancelable que se completa después de un intervalo de tiempo especificado. |
Dispose() |
Libera todos los recursos usados por la instancia actual de la clase Task. |
Dispose(Boolean) |
Elimina el Task, liberando todos sus recursos no administrados. |
Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
FromCanceled(CancellationToken) |
Crea un Task que se completa debido a la cancelación con un token de cancelación especificado. |
FromCanceled<TResult>(CancellationToken) |
Crea un Task<TResult> que se completa debido a la cancelación con un token de cancelación especificado. |
FromException(Exception) |
Crea un Task que se ha completado con una excepción especificada. |
FromException<TResult>(Exception) |
Crea un Task<TResult> que se completa con una excepción especificada. |
FromResult<TResult>(TResult) |
Crea un Task<TResult> que se completa correctamente con el resultado especificado. |
GetAwaiter() |
Obtiene un awaiter usado para esperar este Task. |
GetHashCode() |
Actúa como función hash predeterminada. (Heredado de Object) |
GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
Run(Action) |
Pone en cola el trabajo especificado para ejecutarse en el grupo de subprocesos y devuelve un objeto Task que representa ese trabajo. |
Run(Action, CancellationToken) |
Pone en cola el trabajo especificado para ejecutarse en el grupo de subprocesos y devuelve un objeto Task que representa ese trabajo. Un token de cancelación permite cancelar el trabajo si aún no se ha iniciado. |
Run(Func<Task>) |
Pone en cola el trabajo especificado para ejecutarse en el grupo de subprocesos y devuelve un proxy para la tarea devuelta por |
Run(Func<Task>, CancellationToken) |
Pone en cola el trabajo especificado para ejecutarse en el grupo de subprocesos y devuelve un proxy para la tarea devuelta por |
Run<TResult>(Func<Task<TResult>>) |
Pone en cola el trabajo especificado para ejecutarse en el grupo de subprocesos y devuelve un proxy para el |
Run<TResult>(Func<Task<TResult>>, CancellationToken) |
Pone en cola el trabajo especificado para ejecutarse en el grupo de subprocesos y devuelve un proxy para el |
Run<TResult>(Func<TResult>) |
Pone en cola el trabajo especificado para ejecutarse en el grupo de subprocesos y devuelve un objeto Task<TResult> que representa ese trabajo. Un token de cancelación permite cancelar el trabajo si aún no se ha iniciado. |
Run<TResult>(Func<TResult>, CancellationToken) |
Pone en cola el trabajo especificado para ejecutarse en el grupo de subprocesos y devuelve un objeto |
RunSynchronously() |
Ejecuta el Task sincrónicamente en el TaskScheduleractual. |
RunSynchronously(TaskScheduler) |
Ejecuta el Task sincrónicamente en el TaskScheduler proporcionado. |
Start() |
Inicia el Task, programando para su ejecución en el TaskScheduleractual. |
Start(TaskScheduler) |
Inicia el Task, programando para su ejecución en el TaskSchedulerespecificado. |
ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
Wait() |
Espera a que el Task complete la ejecución. |
Wait(CancellationToken) |
Espera a que el Task complete la ejecución. La espera finaliza si se cancela un token de cancelación antes de que se complete la tarea. |
Wait(Int32) |
Espera a que el Task complete la ejecución dentro de un número especificado de milisegundos. |
Wait(Int32, CancellationToken) |
Espera a que el Task complete la ejecución. La espera finaliza si transcurre un intervalo de tiempo de espera o se cancela un token de cancelación antes de que se complete la tarea. |
Wait(TimeSpan) |
Espera a que el Task complete la ejecución dentro de un intervalo de tiempo especificado. |
Wait(TimeSpan, CancellationToken) |
Espera a que el Task complete la ejecución. |
WaitAll(IEnumerable<Task>, CancellationToken) |
Espera a que todos los objetos de Task proporcionados completen la ejecución a menos que se cancele la espera. |
WaitAll(ReadOnlySpan<Task>) |
Espera a que todos los objetos de Task proporcionados completen la ejecución. |
WaitAll(Task[]) |
Espera a que todos los objetos de Task proporcionados completen la ejecución. |
WaitAll(Task[], CancellationToken) |
Espera a que todos los objetos de Task proporcionados completen la ejecución a menos que se cancele la espera. |
WaitAll(Task[], Int32) |
Espera a que todos los objetos de Task proporcionados completen la ejecución dentro de un número especificado de milisegundos. |
WaitAll(Task[], Int32, CancellationToken) |
Espera a que todos los objetos Task proporcionados completen la ejecución dentro de un número especificado de milisegundos o hasta que se cancele la espera. |
WaitAll(Task[], TimeSpan) |
Espera a que todos los objetos cancelables proporcionados Task completen la ejecución dentro de un intervalo de tiempo especificado. |
WaitAny(Task[]) |
Espera a que cualquiera de los objetos de Task proporcionados complete la ejecución. |
WaitAny(Task[], CancellationToken) |
Espera a que cualquiera de los objetos de Task proporcionados complete la ejecución a menos que se cancele la espera. |
WaitAny(Task[], Int32) |
Espera a que cualquiera de los objetos Task proporcionados complete la ejecución dentro de un número especificado de milisegundos. |
WaitAny(Task[], Int32, CancellationToken) |
Espera a que cualquiera de los objetos Task proporcionados complete la ejecución dentro de un número especificado de milisegundos o hasta que se cancele un token de cancelación. |
WaitAny(Task[], TimeSpan) |
Espera a que cualquiera de los objetos de Task proporcionados complete la ejecución dentro de un intervalo de tiempo especificado. |
WaitAsync(CancellationToken) |
Obtiene un Task que se completará cuando se complete este Task o cuando se haya solicitado la cancelación del CancellationToken especificado. |
WaitAsync(TimeSpan) |
Obtiene un Task que se completará cuando se complete este Task o cuando expire el tiempo de espera especificado. |
WaitAsync(TimeSpan, CancellationToken) |
Obtiene un Task que se completará cuando finalice este Task, cuando expire el tiempo de espera especificado o cuando se haya solicitado la cancelación del CancellationToken especificado. |
WaitAsync(TimeSpan, TimeProvider) |
Obtiene un Task que se completará cuando se complete este Task o cuando expire el tiempo de espera especificado. |
WaitAsync(TimeSpan, TimeProvider, CancellationToken) |
Obtiene un Task que se completará cuando finalice este Task, cuando expire el tiempo de espera especificado o cuando se haya solicitado la cancelación del CancellationToken especificado. |
WhenAll(IEnumerable<Task>) |
Crea una tarea que se completará cuando se hayan completado todos los objetos Task de una colección enumerable. |
WhenAll(ReadOnlySpan<Task>) |
Crea una tarea que se completará cuando se hayan completado todas las tareas proporcionadas. |
WhenAll(Task[]) |
Crea una tarea que se completará cuando se hayan completado todos los objetos Task de una matriz. |
WhenAll<TResult>(IEnumerable<Task<TResult>>) |
Crea una tarea que se completará cuando se hayan completado todos los objetos Task<TResult> de una colección enumerable. |
WhenAll<TResult>(ReadOnlySpan<Task<TResult>>) |
Crea una tarea que se completará cuando se hayan completado todas las tareas proporcionadas. |
WhenAll<TResult>(Task<TResult>[]) |
Crea una tarea que se completará cuando se hayan completado todos los objetos Task<TResult> de una matriz. |
WhenAny(IEnumerable<Task>) |
Crea una tarea que se completará cuando se haya completado cualquiera de las tareas proporcionadas. |
WhenAny(ReadOnlySpan<Task>) |
Crea una tarea que se completará cuando se haya completado cualquiera de las tareas proporcionadas. |
WhenAny(Task, Task) |
Crea una tarea que se completará cuando se haya completado alguna de las tareas proporcionadas. |
WhenAny(Task[]) |
Crea una tarea que se completará cuando se haya completado cualquiera de las tareas proporcionadas. |
WhenAny<TResult>(IEnumerable<Task<TResult>>) |
Crea una tarea que se completará cuando se haya completado cualquiera de las tareas proporcionadas. |
WhenAny<TResult>(ReadOnlySpan<Task<TResult>>) |
Crea una tarea que se completará cuando se haya completado cualquiera de las tareas proporcionadas. |
WhenAny<TResult>(Task<TResult>, Task<TResult>) |
Crea una tarea que se completará cuando se haya completado alguna de las tareas proporcionadas. |
WhenAny<TResult>(Task<TResult>[]) |
Crea una tarea que se completará cuando se haya completado cualquiera de las tareas proporcionadas. |
WhenEach(IEnumerable<Task>) |
Crea un IAsyncEnumerable<T> que producirá las tareas proporcionadas a medida que se completen esas tareas. |
WhenEach(ReadOnlySpan<Task>) |
Crea un IAsyncEnumerable<T> que producirá las tareas proporcionadas a medida que se completen esas tareas. |
WhenEach(Task[]) |
Crea un IAsyncEnumerable<T> que producirá las tareas proporcionadas a medida que se completen esas tareas. |
WhenEach<TResult>(IEnumerable<Task<TResult>>) |
Crea un IAsyncEnumerable<T> que producirá las tareas proporcionadas a medida que se completen esas tareas. |
WhenEach<TResult>(ReadOnlySpan<Task<TResult>>) |
Crea un IAsyncEnumerable<T> que producirá las tareas proporcionadas a medida que se completen esas tareas. |
WhenEach<TResult>(Task<TResult>[]) |
Crea un IAsyncEnumerable<T> que producirá las tareas proporcionadas a medida que se completen esas tareas. |
Yield() |
Crea una tarea a la espera que se devuelve de forma asincrónica al contexto actual cuando se espera. |
Implementaciones de interfaz explícitas
IAsyncResult.AsyncWaitHandle |
Obtiene un WaitHandle que se puede usar para esperar a que se complete la tarea. |
IAsyncResult.CompletedSynchronously |
Obtiene una indicación de si la operación se completó sincrónicamente. |
Métodos de extensión
AsyncWait<TException>(Task) |
Representa una operación asincrónica. |
AwaitWithTimeout(Task, TimeSpan) |
Representa una operación asincrónica. |
ToApm(Task, AsyncCallback, Object) |
Representa una operación asincrónica. |
ToApmEnd(IAsyncResult) |
Representa una operación asincrónica. |
ToApmEnd<TResult>(IAsyncResult) |
Representa una operación asincrónica. |
Wait(Task, TimeSpan, Action<Exception,TimeSpan,String>, String) |
Representa una operación asincrónica. |
WaitForCompletion(Task) |
Representa una operación asincrónica. |
WaitForCompletionNoSpin(Task) |
Representa una operación asincrónica. |
WaitForCompletionNoSpin(Task, TimeSpan) |
Representa una operación asincrónica. |
WaitAsync(Task, TimeSpan, TimeProvider, CancellationToken) |
Obtiene un Task que se completará cuando finalice este Task, cuando expire el tiempo de espera especificado o cuando se haya solicitado la cancelación del CancellationToken especificado. |
DispatcherOperationWait(Task) |
Espera indefinidamente a que se complete el DispatcherOperation subyacente. |
DispatcherOperationWait(Task, TimeSpan) |
Espera la cantidad de tiempo especificada para que se complete el DispatcherOperation subyacente. |
IsDispatcherOperationTask(Task) |
Devuelve un valor que indica si este Task está asociado a un DispatcherOperation. |
AsAsyncAction(Task) |
Devuelve una acción asincrónica de Windows Runtime que representa una tarea iniciada. |
Se aplica a
Seguridad para subprocesos
Todos los miembros de Task, excepto para Dispose(), son seguros para subprocesos y se pueden usar de varios subprocesos simultáneamente.
Consulte también
- Task<TResult>
- biblioteca paralela de tareas (TPL) de
- patrón asincrónico basado en tareas (TAP) en .NET: Introducción e información general
- programación asincrónica basada en tareas
- ejemplos de para la programación en paralelo con .NET Core y .NET Standard