IAsyncInfo Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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:
- IAsyncAction
- IAsyncActionWithProgress<TProgress>
- IAsyncOperation<TResult>
- IAsyncOperationWithProgress<TResult,TProgress>
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für