Freigeben über

IAsyncInfo Schnittstelle

  • Referenz

Definition

Namespace:
Windows.Foundation
Bearbeiten

Unterstützt asynchrone Aktionen und Vorgänge. IAsyncInfo ist eine Basisschnittstelle für IAsyncAction, IAsyncActionWithProgress<TProgress>, IAsyncOperation<TResult> und IAsyncOperationWithProgress<TResult,TProgress>, die jeweils Kombinationen von Rückgabetyp und Fortschritt für eine asynchrone Methode unterstützen.

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
Abgeleitet
Attribute
ContractVersionAttribute GuidAttribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.FoundationContract (eingeführt in v1.0)

Hinweise

IAsyncInfo ist eine geerbte Schnittstelle für jede der vier Windows-Runtime-Schnittstellen, die für die asynchrone Methodenunterstützung verwendet werden. Dies sind:

Wenn Sie asynchrone Methoden im App-Code verwenden, werden diese Schnittstellen in der Regel nicht als Rückgabewert angezeigt. Das liegt daran, dass Sie fast immer die sprachspezifische, wartende Syntax verwenden, die die Schnittstellen intern verarbeitet. Weitere Informationen finden Sie unter Asynchrone Programmierungoder eine der sprachspezifischen Leitfäden für die asynchrone Programmierung von Windows-Runtime (Aufrufen asynchroner APIs in C# oder Visual Basic, C++-, JavaScript-).

Bei den meisten App-Code ist es ungewöhnlich, IAsyncInfo als API zu verwenden, auch wenn Sie keine erwartete Syntax verwenden. Jede Der Sprachen weist Erweiterungspunkte auf, die im Allgemeinen einfacher zu verwenden sind als die Windows-RuntimeIAsyncInfo-Schnittstelle. JavaScript weist die dann/erledigt Syntax auf. .NET verfügt über die AsTask- Erweiterungsmethode, und sobald die IAsyncAction- in eine Taskkonvertiert wird, ist es einfacher, abzubrechen, Benachrichtigungen zum Abschluss zu erhalten usw. Für C++/CX können Sie die Aufrufe mithilfe der Concurrency Runtimeumschließen. Mit anderen Worten: IAsyncInfo ist eine Infrastruktur auf Laufzeitebene, die jede der Sprachen als Framework verwendet, um die erwartbare Syntax auf eigene Weise zu unterstützen.

Wenn Sie eine benutzerdefinierte Aktion oder einen benutzerdefinierten Vorgang (ein erweitertes Szenario) implementieren, implementieren Sie IAsyncAction- nicht direkt. Implementieren Sie stattdessen eine der vier zuvor aufgeführten Schnittstellen.

Eigenschaften

ErrorCode

Ruft eine Zeichenfolge ab, die eine Fehlerbedingung des asynchronen Vorgangs beschreibt.
Id

Ruft das Handle des asynchronen Vorgangs ab.
Status

Ruft einen Wert ab, der den Status des asynchronen Vorgangs angibt.

Methoden

Cancel()

Bricht den asynchronen Vorgang ab.
Close()

Schließt den asynchronen Vorgang.

Gilt für:

Weitere Informationen