IAsyncResult Интерфейс

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Сборка:

mscorlib.dll

Сборка:

netstandard.dll

Представляет состояние асинхронной операции.

C#

public interface IAsyncResult

C#

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

Производный

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

Атрибуты

ComVisibleAttribute

Примеры

В следующем примере показано, как использовать AsyncWaitHandle свойство для получения WaitHandleи как ожидать асинхронного вызова делегата. Объект WaitHandle получает сигнал после завершения асинхронного вызова; его можно дождаться путем вызова метода WaitOne .

Пример состоит из двух классов: класса, содержащего метод, который вызывается асинхронно, и класс, содержащий Main метод, который выполняет вызов.

Дополнительные сведения и дополнительные примеры асинхронных методов вызова с помощью делегатов см. в разделе "Асинхронные вызовы синхронных методов".

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

Комментарии

Интерфейс IAsyncResult реализуется классами, содержащими методы, которые могут работать асинхронно. Это тип возвращаемых методов, инициирующих асинхронную операцию, например FileStream.BeginReadметоды, которые завершали асинхронную операцию, например FileStream.EndRead. IAsyncResult объекты также передаются в методы, вызываемые делегатами AsyncCallback при завершении асинхронной операции.

Объект, поддерживающий IAsyncResult интерфейс, сохраняет сведения о состоянии для асинхронной операции и предоставляет объект синхронизации, позволяющий сигнализировать потоки после завершения операции.

Примечание

Класс AsyncResult представляет собой реализацию IAsyncResult , возвращаемую методом BeginInvoke при использовании делегата для асинхронного вызова метода.

Подробное описание использования IAsyncResult интерфейса см. в разделе " Асинхронные вызовы синхронных методов ".

Свойства

AsyncState	Получает определенный пользователем объект, который определяет или содержит сведения об асинхронной операции.
AsyncWaitHandle	Возвращает дескриптор WaitHandle, используемый для ожидания завершения асинхронной операции.
CompletedSynchronously	Возвращает значение, указывающее, выполнялась ли асинхронная операция синхронно.
IsCompleted	Возвращает значение, указывающее, выполнена ли асинхронная операция.

Применяется к