IAsyncResult.AsyncWaitHandle-Eigenschaft

Ruft eine WaitHandle-Klasse auf, die für das Warten auf den Abschluss eines asynchronen Vorgangs verwendet wird.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
ReadOnly Property AsyncWaitHandle As WaitHandle
'Usage
Dim instance As IAsyncResult
Dim value As WaitHandle

value = instance.AsyncWaitHandle

WaitHandle AsyncWaitHandle { get; }

property WaitHandle^ AsyncWaitHandle {
    WaitHandle^ get ();
}

/** @property */
WaitHandle get_AsyncWaitHandle ()

function get AsyncWaitHandle () : WaitHandle

Eigenschaftenwert

Eine WaitHandle-Klasse, die für das Warten auf den Abschluss eines asynchronen Vorgangs verwendet wird.

Hinweise

Der Rückgabewert ermöglicht es dem Client, auf den Abschluss eines asynchronen Vorgangs zu warten, anstatt IsCompleted abzufragen. Der Rückgabewert kann zum Durchführen einer der folgenden Operationen verwendet werden: WaitOne, WaitAny oder WaitAll.

Die Common Language Runtime stellt eine Reihe von wait-fähigen Objekten bereit, die die Grundelemente der Win32-Synchronisierung spiegeln, z. B. ManualResetEvent, AutoResetEvent und Mutex.

Hinweise für Implementierer Das Objekt, das IAsyncResult implementiert, muss das WaitHandle erst erstellen, wenn die AsyncWaitHandle-Eigenschaft gelesen wurde. Dies ist der IAsyncResult-Implementierung freigestellt. Wenn die Implementierung eine AsyncWaitHandle-Eigenschaft erstellt, muss diese auch die Meldung an die WaitHandle-Klasse durchführen, die den Wartevorgang zur entsprechenden Zeit beendet. System.Runtime.Remoting.Messaging.AsyncResult beendet z. B. den Wartevorgang für den Aufrufer, wenn eine asynchron aufgerufene Methode zurückgegeben wird. Die AsyncWaitHandle-Eigenschaft muss nach dem Erstellen so lange bereitgehalten werden, bis der Benutzer eine Methode aufruft, die den asynchronen Vorgang abschließt. Zu diesem Zeitpunkt kann das Objekt hinter AsyncWaitHandle verworfen werden.

Hinweise für Aufrufer Clients, die auf den Abschluss eines Vorgangs warten (im Gegensatz zur Abfrage), rufen mit dieser Eigenschaft ein Synchronisierungsobjekt ab, auf das gewartet werden kann.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

IAsyncResult-Schnittstelle
IAsyncResult-Member
System-Namespace