IAsyncResult Interfejs

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Zestaw:

mscorlib.dll

Zestaw:

netstandard.dll

Reprezentuje stan operacji asynchronicznej.

C#

public interface IAsyncResult

C#

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

Pochodne

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

Atrybuty

ComVisibleAttribute

Przykłady

W poniższym przykładzie pokazano, jak za pomocą AsyncWaitHandle właściwości uzyskać WaitHandleobiekt i jak czekać na asynchroniczne wywołanie delegata. Element WaitHandle jest sygnalizowany po zakończeniu wywołania asynchronicznego i można poczekać, wywołując metodę WaitOne .

Przykład składa się z dwóch klas: klasy, która zawiera metodę wywoływaną asynchronicznie, oraz klasę zawierającą Main metodę, która wykonuje wywołanie.

Aby uzyskać więcej informacji i więcej przykładów asynchronicznego wywoływania metod przy użyciu delegatów, zobacz Wywoływanie metod synchronicznych asynchronicznie.

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.".
 */

Uwagi

Interfejs IAsyncResult jest implementowany przez klasy zawierające metody, które mogą działać asynchronicznie. Jest to zwracany typ metod, które inicjują operację asynchroniczną, taką jak FileStream.BeginRead, i są przekazywane do metod, które kończą operację asynchroniczną, taką jak FileStream.EndRead. IAsyncResult Obiekty są również przekazywane do metod wywoływanych przez AsyncCallback delegatów po zakończeniu operacji asynchronicznej.

Obiekt obsługujący IAsyncResult interfejs przechowuje informacje o stanie dla operacji asynchronicznej i udostępnia obiekt synchronizacji, aby umożliwić sygnalizowanie wątków po zakończeniu operacji.

Uwaga

Klasa AsyncResult jest implementacją IAsyncResult , która jest zwracana przez BeginInvoke metodę, gdy używasz delegata do wywołania metody asynchronicznie.

Szczegółowy opis sposobu użycia interfejsu IAsyncResult znajduje się w temacie Wywoływanie metod synchronicznych asynchronicznie .

Właściwości

AsyncState	Pobiera obiekt zdefiniowany przez użytkownika, który kwalifikuje się lub zawiera informacje o operacji asynchronicznej.
AsyncWaitHandle	Pobiera element WaitHandle służący do oczekiwania na zakończenie operacji asynchronicznej.
CompletedSynchronously	Pobiera wartość wskazującą, czy operacja asynchroniczna została ukończona synchronicznie.
IsCompleted	Pobiera wartość wskazującą, czy operacja asynchroniczna została ukończona.

Dotyczy