Данная статья переведена с помощью средств машинного перевода. Чтобы просмотреть ее на английском языке, установите флажок Английский. Вы также можете просматривать английский текст во всплывающем окне, наводя указатель мыши на переведенный текст.
Перевод
Английский

Интерфейс IAsyncResult

 

Опубликовано: Октябрь 2016

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

Пространство имен:   System
Сборка:  mscorlib (в mscorlib.dll)

[ComVisibleAttribute(true)]
public interface IAsyncResult

ИмяОписание
System_CAPS_pubpropertyAsyncState

Получает определенный пользователем объект, который определяет или содержит сведения об асинхронной операции.

System_CAPS_pubpropertyAsyncWaitHandle

Возвращает дескриптор WaitHandle, используемый для ожидания завершения асинхронной операции.

System_CAPS_pubpropertyCompletedSynchronously

Возвращает значение, указывающее, выполнялась ли асинхронная операция синхронно.

System_CAPS_pubpropertyIsCompleted

Возвращает значение, указывающее, выполнена ли асинхронная операция.

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

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

System_CAPS_noteПримечание

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

Подробное описание того, как IAsyncResult используется интерфейс см. в разделе Calling Synchronous Methods Asynchronously раздела.

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

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

Дополнительные сведения и Дополнительные примеры асинхронного вызова методов с помощью делегатов см. в разделе Calling Synchronous Methods Asynchronously.

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

Универсальная платформа Windows
Доступно с 8
.NET Framework
Доступно с 1.1
Переносимая библиотека классов
Поддерживается в: переносимые платформы .NET
Silverlight
Доступно с 2.0
Windows Phone Silverlight
Доступно с 7.0
Windows Phone
Доступно с 8.1
Вернуться в начало
Показ: