Información
El tema que ha solicitado se muestra abajo. Sin embargo, este tema no se encuentra en la biblioteca.

Task<TResult> (Clase)

Representa una operación asincrónica que puede devolver un valor.

System.Object
  System.Threading.Tasks.Task
    System.Threading.Tasks.Task<TResult>

Espacio de nombres:  System.Threading.Tasks
Ensamblado:  mscorlib (en mscorlib.dll)

[HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization = true, 
	ExternalThreading = true)]
public class Task<TResult> : Task

Parámetros de tipo

TResult

El tipo del resultado generado por Task<TResult>.

El tipo Task<TResult> expone los siguientes miembros.

  NombreDescripción
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsTask<TResult>(Func<TResult>)Inicializa una nueva Task<TResult> con la función especificada.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsTask<TResult>(Func<TResult>, CancellationToken)Inicializa una nueva Task<TResult> con la función especificada.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsTask<TResult>(Func<TResult>, TaskCreationOptions)Inicializa una nueva Task<TResult> con la función y las opciones de creación especificadas.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsTask<TResult>(Func<Object, TResult>, Object)Inicializa una nueva instancia de Task<TResult> con la función y el estado especificados.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsTask<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions)Inicializa una nueva Task<TResult> con la función y las opciones de creación especificadas.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsTask<TResult>(Func<Object, TResult>, Object, CancellationToken)Inicializa un nuevo objeto Task<TResult> con la acción, el estado y las opciones especificados.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsTask<TResult>(Func<Object, TResult>, Object, TaskCreationOptions)Inicializa un nuevo objeto Task<TResult> con la acción, el estado y las opciones especificados.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsTask<TResult>(Func<Object, TResult>, Object, CancellationToken, TaskCreationOptions)Inicializa un nuevo objeto Task<TResult> con la acción, el estado y las opciones especificados.
Arriba

  NombreDescripción
Propiedad públicaCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsAsyncStateObtiene el objeto de estado que se proporcionó cuando se creó el objeto Task, o null si no se proporcionó ningún objeto de estado. (Se hereda de Task).
Propiedad públicaCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCreationOptionsObtiene el objeto TaskCreationOptions usado para crear esta tarea. (Se hereda de Task).
Propiedad públicaCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsExceptionObtiene la excepción AggregateException que causó la finalización prematura del objeto Task. Si Task se completó correctamente o no ha iniciado ninguna excepción, el valor devuelto será null. (Se hereda de Task).
Propiedad públicaMiembro estáticoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsFactoryProporciona acceso a métodos de generador para crear instancias de Task<TResult>.
Propiedad públicaCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsIdObtiene un identificador único para esta instancia de Task. (Se hereda de Task).
Propiedad públicaCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsIsCanceledObtiene un valor que indica si esta instancia de Task ha dejado de ejecutarse debido a una cancelación. (Se hereda de Task).
Propiedad públicaCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsIsCompletedObtiene un valor que indica si se ha completado esta instancia de Task. (Se hereda de Task).
Propiedad públicaCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsIsFaultedObtiene un valor que indica si el objeto Task se ha completado debido a una excepción no controlada. (Se hereda de Task).
Propiedad públicaCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsResultObtiene el valor de resultado de este objeto Task<TResult>.
Propiedad públicaCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsStatusObtiene el objeto TaskStatus de esta tarea. (Se hereda de Task).
Arriba

  NombreDescripción
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsConfigureAwaitConfigura un awaiter utilizado para esperar este objeto Task<TResult>.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith(Action<Task>)Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto Task de destino. (Se hereda de Task).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith(Action<Task<TResult>>)Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto Task<TResult> de destino.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith(Action<Task>, CancellationToken)Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto Task de destino. (Se hereda de Task).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith(Action<Task>, TaskContinuationOptions)Crea una continuación que se ejecuta según el objeto TaskContinuationOptions especificado. (Se hereda de Task).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith(Action<Task>, TaskScheduler)Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto Task de destino. (Se hereda de Task).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith(Action<Task, Object>, Object)Crea una continuación que se ejecuta cuando se completa el objeto Task de destino. (Se hereda de Task).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith(Action<Task<TResult>>, CancellationToken)Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto Task<TResult> de destino.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith(Action<Task<TResult>>, TaskContinuationOptions)Crea una continuación que se ejecuta según la condición especificada en continuationOptions.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith(Action<Task<TResult>>, TaskScheduler)Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto Task<TResult> de destino.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith(Action<Task<TResult>, Object>, Object)Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith(Action<Task, Object>, Object, CancellationToken)Crea una continuación que se ejecuta cuando se completa el objeto Task de destino. (Se hereda de Task).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith(Action<Task, Object>, Object, TaskContinuationOptions)Crea una continuación que se ejecuta cuando se completa el objeto Task de destino. (Se hereda de Task).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith(Action<Task, Object>, Object, TaskScheduler)Crea una continuación que se ejecuta cuando se completa el objeto Task de destino. (Se hereda de Task).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith(Action<Task<TResult>, Object>, Object, CancellationToken)Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith(Action<Task<TResult>, Object>, Object, TaskContinuationOptions)Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith(Action<Task<TResult>, Object>, Object, TaskScheduler)Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith(Action<Task>, CancellationToken, TaskContinuationOptions, TaskScheduler)Crea una continuación que se ejecuta según el objeto TaskContinuationOptions especificado. (Se hereda de Task).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith(Action<Task<TResult>>, CancellationToken, TaskContinuationOptions, TaskScheduler)Crea una continuación que se ejecuta según la condición especificada en continuationOptions.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith(Action<Task, Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)Crea una continuación que se ejecuta cuando se completa el objeto Task de destino. (Se hereda de Task).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith(Action<Task<TResult>, Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith<TResult>(Func<Task, TResult>)Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto Task de destino. (Se hereda de Task).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith<TNewResult>(Func<Task<TResult>, TNewResult>)Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto Task<TResult> de destino.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith<TResult>(Func<Task, TResult>, CancellationToken)Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto Task de destino. (Se hereda de Task).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith<TResult>(Func<Task, TResult>, TaskContinuationOptions)Crea una continuación que se ejecuta según la condición especificada en continuationOptions. (Se hereda de Task).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith<TResult>(Func<Task, TResult>, TaskScheduler)Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto Task de destino. (Se hereda de Task).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith<TResult>(Func<Task, Object, TResult>, Object)Crea una continuación que se ejecuta cuando se completa el objeto Task de destino. (Se hereda de Task).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith<TNewResult>(Func<Task<TResult>, TNewResult>, CancellationToken)Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto Task<TResult> de destino.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith<TNewResult>(Func<Task<TResult>, TNewResult>, TaskContinuationOptions)Crea una continuación que se ejecuta según la condición especificada en continuationOptions.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith<TNewResult>(Func<Task<TResult>, TNewResult>, TaskScheduler)Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto Task<TResult> de destino.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith<TNewResult>(Func<Task<TResult>, Object, TNewResult>, Object)Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith<TResult>(Func<Task, Object, TResult>, Object, CancellationToken)Crea una continuación que se ejecuta cuando se completa el objeto Task de destino. (Se hereda de Task).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith<TResult>(Func<Task, Object, TResult>, Object, TaskContinuationOptions)Crea una continuación que se ejecuta cuando se completa el objeto Task de destino. (Se hereda de Task).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith<TResult>(Func<Task, Object, TResult>, Object, TaskScheduler)Crea una continuación que se ejecuta cuando se completa el objeto Task de destino. (Se hereda de Task).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith<TNewResult>(Func<Task<TResult>, Object, TNewResult>, Object, CancellationToken)Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith<TNewResult>(Func<Task<TResult>, Object, TNewResult>, Object, TaskContinuationOptions)Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith<TNewResult>(Func<Task<TResult>, Object, TNewResult>, Object, TaskScheduler)Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith<TResult>(Func<Task, TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)Crea una continuación que se ejecuta según la condición especificada en continuationOptions. (Se hereda de Task).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith<TNewResult>(Func<Task<TResult>, TNewResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)Crea una continuación que se ejecuta según la condición especificada en continuationOptions.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith<TResult>(Func<Task, Object, TResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)Crea una continuación que se ejecuta cuando se completa el objeto Task de destino. (Se hereda de Task).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsContinueWith<TNewResult>(Func<Task<TResult>, Object, TNewResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.
Método públicoDispose()Libera todos los recursos usados por la instancia actual de la clase Task. (Se hereda de Task).
Método protegidoDispose(Boolean)Desecha el objeto Task y libera todos sus recursos no administrados. (Se hereda de Task).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsGetAwaiterObtiene un awaiter utilizado para esperar este objeto Task<TResult>.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método protegidoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsRunSynchronously()Ejecuta sincrónicamente el objeto Task en el objeto TaskScheduler actual. (Se hereda de Task).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsRunSynchronously(TaskScheduler)Ejecuta sincrónicamente el objeto Task en el objeto TaskScheduler especificado. (Se hereda de Task).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsStart()Inicia el objeto Task, programando su ejecución en el objeto TaskScheduler actual. (Se hereda de Task).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsStart(TaskScheduler)Inicia el objeto Task, programando su ejecución en el objeto TaskScheduler especificado. (Se hereda de Task).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWait()Espera a que se complete la ejecución del objeto Task. (Se hereda de Task).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWait(CancellationToken)Espera a que se complete la ejecución del objeto cancelable Task. (Se hereda de Task).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWait(Int32)Espera a que Task complete la ejecución dentro de un número de milisegundos. (Se hereda de Task).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWait(TimeSpan)Espera a que Task complete la ejecución dentro de un intervalo de tiempo especificado. (Se hereda de Task).
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWait(Int32, CancellationToken)Espera a que se complete la ejecución del objeto cancelable Task. (Se hereda de Task).
Arriba

  NombreDescripción
Método de extensión públicoCompatible con .NET para aplicaciones de la Tienda WindowsAsAsyncActionDevuelve una acción asincrónica de Windows en tiempo de ejecución que representa una tarea iniciada. (Definido por WindowsRuntimeSystemExtensions).
Método de extensión públicoCompatible con .NET para aplicaciones de la Tienda WindowsAsAsyncOperation<TResult>Devuelve una operación asincrónica de Windows en tiempo de ejecución que representa una tarea iniciada que devuelve un resultado. (Definido por WindowsRuntimeSystemExtensions).
Método de extensión públicoDispatcherOperationWait()Sobrecargado. Espera indefinidamente a que se complete la DispatcherOperation subyacente. (Definido por TaskExtensions).
Método de extensión públicoDispatcherOperationWait(TimeSpan)Sobrecargado. Espera la cantidad de tiempo especificada para que se complete el DispatcherOperation subyacente. (Definido por TaskExtensions).
Método de extensión públicoIsDispatcherOperationTaskDevuelve un valor que indica si este Task está asociado con un DispatcherOperation. (Definido por TaskExtensions).
Método de extensión públicoToObservable()Sobrecargado. (Definido por TaskObservableExtensions).
Método de extensión públicoToObservable<TResult>()Sobrecargado. (Definido por TaskObservableExtensions).
Arriba

  NombreDescripción
Implementación explícita de interfacesPropiedad privadaCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsIAsyncResult.AsyncWaitHandleObtiene un identificador WaitHandle que se puede usar para esperar a que se complete la tarea. (Se hereda de Task).
Implementación explícita de interfacesPropiedad privadaCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsIAsyncResult.CompletedSynchronouslyObtiene un valor que indica si la operación se ha completado sincrónicamente. (Se hereda de Task).
Arriba

Las instancias de Task<TResult> se pueden crear de una serie de maneras. El enfoque más común es utilizar la propiedad Factory de la tarea para recuperar una instancia de TaskFactory<TResult> que se puede utilizar para crear tareas para varios propósitos. Por ejemplo, para crear una Task<TResult> que ejecuta una función, se puede utilizar el método StartNew del generador:

// C# 
var t = Task<int>.Factory.StartNew(() => GenerateResult());

' Visual Basic
Dim t = Task(Of Integer).Factory.StartNew(Function() GenerateResult()) 

Para obtener ejemplos más completos, vea Paralelismo de tareas (Task Parallel Library).

La clase Task<TResult> también proporciona constructores que inicializan la tarea pero que no la programan para su ejecución. Por razones de rendimiento, el método StartNew debería ser el mecanismo preferido para crear y programar tareas computacionales, pero para escenarios donde se debe separar la creación y la programación, se pueden utilizar constructores, y el método Start de la tarea se puede utilizar a continuación para programar la tarea para su ejecución en un momento posterior.

NotaNota

El atributo HostProtectionAttribute aplicado a este tipo o miembro tiene el siguiente valor de propiedad Resources: Synchronization | ExternalThreading. El atributo HostProtectionAttribute no afecta a las aplicaciones de escritorio (que normalmente se inician haciendo doble clic en un icono, escribiendo un comando o introduciendo una dirección URL en el explorador). Para obtener más información, vea la clase HostProtectionAttribute o Programación en SQL Server y atributos de protección de host.

.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4

.NET Framework Client Profile

Compatible con: 4

Biblioteca de clases portable

Compatible con: Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

.NET para aplicaciones de Windows Phone

Compatible con: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros de Task<TResult>, excepto Dispose, son seguros para subprocesos y se pueden usar desde varios subprocesos simultáneamente.

Adiciones de comunidad

Mostrar:
© 2014 Microsoft