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

IAsyncInfo Интерфейс

  • Ссылка

Определение

Пространство имен:
Windows.Foundation
Изменить

Поддерживает асинхронные действия и операции. IAsyncInfo — это базовый интерфейс для IAsyncAction, IAsyncActionWithProgressTProgress, IAsyncOperation TResult и IAsyncOperationWithProgressTResult,TProgress, каждая из которых поддерживает сочетания возвращаемого типа и хода выполнения для асинхронного метода.

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
Производный
Атрибуты
ContractVersionAttribute GuidAttribute

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0)
API contract
Windows.Foundation.FoundationContract (появилось в v1.0)

Комментарии

IAsyncInfo — это унаследованный интерфейс для каждого из 4 интерфейсов среды выполнения Windows, используемых для асинхронной поддержки методов. Ниже приведены следующие параметры:

При использовании асинхронных методов в коде приложения обычно не отображается ни один из этих интерфейсов в качестве возвращаемого значения. Это связано с тем, что вы почти всегда используете ожидаемый синтаксис для конкретного языка, который обрабатывает интерфейсы внутренне. Дополнительные сведения см. в асинхронном программированииили в одном из руководств по асинхронным программированию среды выполнения Windows (Вызов асинхронных API в C# или Visual Basic, C++, JavaScript).

Для большинства кода приложений редко используется IAsyncInfo в качестве API, даже если вы не используете ожидаемый синтаксис. Каждый из языков имеет точки расширения, которые обычно проще использовать, чем интерфейс Среды выполнения WindowsIAsyncInfo. JavaScript имеет синтаксис . В .NET есть метод расширения AsTask, и после преобразования IAsyncAction взадачи проще отменить, получить уведомление о завершении и т. д. Для C++/CX можно упаковать вызовы с помощью среды выполнения параллелизма . Другими словами, IAsyncInfo — это инфраструктура уровня среды выполнения, которая каждый из языков используется в качестве платформы для поддержки ожидаемого синтаксиса собственным образом.

Если вы реализуете настраиваемое действие или пользовательскую операцию (расширенный сценарий), не реализуйте IAsyncAction напрямую. Реализуйте один из 4 интерфейсов, перечисленных ранее.

Свойства

ErrorCode

Возвращает строку, описывающую условие ошибки асинхронной операции.
Id

Возвращает дескриптор асинхронной операции.
Status

Возвращает значение, указывающее состояние асинхронной операции.

Методы

Cancel()

Отменяет асинхронную операцию.
Close()

Закрывает асинхронную операцию.

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

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