IAsyncResult Schnittstelle

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Stellt den Status eines asynchronen Vorgangs dar.

C#

public interface IAsyncResult

C#

[System.Runtime.InteropServices.ComVisible(true)]
public interface IAsyncResult

Abgeleitet

System.IdentityModel.AsyncResult

System.IdentityModel.Selectors.SecurityTokenProvider.SecurityTokenAsyncResult

System.Runtime.Remoting.Messaging.AsyncResult

System.Threading.Tasks.Task

System.Transactions.CommittableTransaction

System.Web.Services.Protocols.WebClientAsyncResult

Attribute

ComVisibleAttribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie sie die AsyncWaitHandle Eigenschaft zum Abrufen einer WaitHandleStellvertretung und zum Warten auf einen asynchronen Aufruf einer Stellvertretung verwenden. Das WaitHandle wird bei Beendigung des asynchronen Aufrufs signalisiert, und durch Aufrufen der WaitOne -Methode kann darauf gewartet werden.

Das Beispiel besteht aus zwei Klassen: die Klasse, die die Methode enthält, die asynchron aufgerufen wird, und die Klasse, die die Main Methode enthält, die den Aufruf vornimmt.

Weitere Informationen und weitere Beispiele für Aufrufmethoden asynchron mithilfe von Stellvertretungen finden Sie unter asynchrones Aufrufen synchroner Methoden.

C#

using System;
using System.Threading;

namespace Examples.AdvancedProgramming.AsynchronousOperations
{
    public class AsyncDemo
    {
        // The method to be executed asynchronously.
        public string TestMethod(int callDuration, out int threadId)
        {
            Console.WriteLine("Test method begins.");
            Thread.Sleep(callDuration);
            threadId = Thread.CurrentThread.ManagedThreadId;
            return String.Format("My call time was {0}.", callDuration.ToString());
        }
    }
    // The delegate must have the same signature as the method
    // it will call asynchronously.
    public delegate string AsyncMethodCaller(int callDuration, out int threadId);
}

C#

using System;
using System.Threading;

namespace Examples.AdvancedProgramming.AsynchronousOperations
{
    public class AsyncMain
    {
        static void Main()
        {
            // The asynchronous method puts the thread id here.
            int threadId;

            // Create an instance of the test class.
            AsyncDemo ad = new AsyncDemo();

            // Create the delegate.
            AsyncMethodCaller caller = new AsyncMethodCaller(ad.TestMethod);

            // Initiate the asychronous call.
            IAsyncResult result = caller.BeginInvoke(3000,
                out threadId, null, null);

            Thread.Sleep(0);
            Console.WriteLine("Main thread {0} does some work.",
                Thread.CurrentThread.ManagedThreadId);

            // Wait for the WaitHandle to become signaled.
            result.AsyncWaitHandle.WaitOne();

            // Perform additional processing here.
            // Call EndInvoke to retrieve the results.
            string returnValue = caller.EndInvoke(out threadId, result);

            // Close the wait handle.
            result.AsyncWaitHandle.Close();

            Console.WriteLine("The call executed on thread {0}, with return value \"{1}\".",
                threadId, returnValue);
        }
    }
}

/* This example produces output similar to the following:

Main thread 1 does some work.
Test method begins.
The call executed on thread 3, with return value "My call time was 3000.".
 */

Hinweise

Die IAsyncResult Schnittstelle wird durch Klassen implementiert, die Methoden enthalten, die asynchron funktionieren können. Es ist der Rückgabetyp von Methoden, die einen asynchronen Vorgang initiieren, z FileStream.BeginRead. B. , und es wird an Methoden übergeben, die einen asynchronen Vorgang abschließen, z FileStream.EndRead. B. . IAsyncResult Objekte werden auch an Methoden übergeben, die von AsyncCallback Stellvertretungen aufgerufen werden, wenn ein asynchroner Vorgang abgeschlossen ist.

Ein Objekt, das die IAsyncResult Schnittstelle unterstützt, speichert Zustandsinformationen für einen asynchronen Vorgang und stellt ein Synchronisierungsobjekt bereit, damit Threads beim Abschluss des Vorgangs signalisiert werden können.

Hinweis

Die AsyncResult Klasse ist die Implementierung, IAsyncResult die von der BeginInvoke Methode zurückgegeben wird, wenn Sie eine Stellvertretung zum asynchronen Aufrufen einer Methode verwenden.

Eine detaillierte Beschreibung der Verwendung der IAsyncResult Schnittstelle finden Sie im Thema " Synchrone Aufrufmethoden asynchron ".

Eigenschaften

AsyncState	Ruft ein benutzerdefiniertes Objekt ab, das einen asynchronen Vorgang qualifiziert oder Informationen darüber enthält.
AsyncWaitHandle	Ruft einen WaitHandle ab, der verwendet wird, um auf den Abschluss eines asynchronen Vorgangs zu warten.
CompletedSynchronously	Ruft einen Wert ab, der angibt, ob der asynchrone Vorgang synchron abgeschlossen wurde.
IsCompleted	Ruft einen Wert ab, der angibt, ob der asynchrone Vorgang abgeschlossen wurde.

Gilt für