Compartir a través de


IAsyncInfo Interfaz

Definición

Admite acciones y operaciones asincrónicas. IAsyncInfo es una interfaz base para IAsyncAction , IAsyncActionWithProgressTProgress, IAsyncOperationTResult y IAsyncOperationWithProgressTResult,TProgress, cada uno de los cuales admite combinaciones de tipo de valor devuelto y progreso para un método asincrónico.

public interface class IAsyncInfo
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(54, 0, 0, 192, 0, 0, 0, 0, 0, 0, 70)]
struct IAsyncInfo
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
[Windows.Foundation.Metadata.Guid(54, 0, 0, 192, 0, 0, 0, 0, 0, 0, 70)]
public interface IAsyncInfo
Public Interface IAsyncInfo
Derivado
Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Foundation.FoundationContract (se introdujo en la versión v1.0)

Comentarios

IAsyncInfo es una interfaz heredada para cada una de las 4 interfaces de Windows Runtime que se usan para la compatibilidad con métodos asincrónicos. Estos son:

Cuando se usan métodos asincrónicos en el código de la aplicación, normalmente no se ve ninguna de estas interfaces como valor devuelto. Esto se debe a que casi siempre usa la sintaxis awaitable específica del lenguaje, que controla las interfaces internamente. Para obtener más información, consulta programación asincrónica, o una de las guías específicas del lenguaje para la programación asincrónica de Windows Runtime (Llamar a API asincrónicas en C# o Visual Basic, de C++, JavaScript).

Para la mayoría del código de la aplicación, es poco habitual usar IAsyncInfo como API incluso si no usa una sintaxis que se puede esperar. Cada uno de los lenguajes tiene puntos de extensión que generalmente son más fáciles de usar que es la interfaz Windows RuntimeIAsyncInfo. JavaScript tiene la sintaxis . .NET tiene el método de extensión AsTask y, una vez que el IAsyncAction se convierte en una Task, es más fácil cancelar, obtener notificaciones al finalizar, etc. Para C++/CX, puede encapsular las llamadas mediante el entorno de ejecución de simultaneidad de . En otras palabras, IAsyncInfo es una infraestructura de nivel de tiempo de ejecución, que cada uno de los lenguajes usa como marco para admitir la sintaxis que se puede esperar de forma propia.

Si va a implementar una acción personalizada o una operación personalizada (un escenario avanzado), no implemente IAsyncAction directamente. Implemente una de las 4 interfaces enumeradas anteriormente en su lugar.

Propiedades

ErrorCode

Obtiene una cadena que describe una condición de error de la operación asincrónica.

Id

Obtiene el identificador de la operación asincrónica.

Status

Obtiene un valor que indica el estado de la operación asincrónica.

Métodos

Cancel()

Cancela la operación asincrónica.

Close()

Cierra la operación asincrónica.

Se aplica a

Consulte también