IAsyncInfo Schnittstelle

  • Referenz

Definition

Namespace:
Windows.Foundation
Bearbeiten

Unterstützt asynchrone Aktionen und Vorgänge. IAsyncInfo ist eine Basisschnittstelle für IAsyncAction, IAsyncActionWithProgress<>, IAsyncOperation<TResult> und IAsyncOperationWithProgress<TResult,TProgress>, die jeweils Kombinationen aus 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. Diese lauten wie folgt:

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

Für den meisten App-Code ist es ungewöhnlich, IAsyncInfo als API zu verwenden, auch wenn Sie keine erwartete Syntax verwenden. Jede der Sprachen verfügt über Erweiterungspunkte, die im Allgemeinen einfacher zu verwenden sind als die Windows-RuntimeIAsyncInfo-Schnittstelle. JavaScript verfügt über die Syntax "then/done ". .NET verfügt über die AsTask-Erweiterungsmethode , und sobald die IAsyncAction in einen Task konvertiert wurde, ist es einfacher, abzubrechen, Benachrichtigungen bei Abschluss zu erhalten usw. Für C++/CX können Sie die Aufrufe mit der Concurrency Runtime umschließen. Mit anderen Worten, IAsyncInfo ist eine Infrastruktur auf Laufzeitebene, die jede der Sprachen als Framework verwendet, um die erwartbare Syntax auf ihre eigene Weise zu unterstützen.

Wenn Sie eine benutzerdefinierte Aktion oder einen benutzerdefinierten Vorgang implementieren (ein erweitertes Szenario), 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 die status des asynchronen Vorgangs angibt.

Methoden

Cancel()

Bricht den asynchronen Vorgang ab.
Close()

Schließt den asynchronen Vorgang.

Gilt für:

Weitere Informationen