IAsyncResult Interfaccia

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Rappresenta lo stato di un'operazione asincrona.

C#

public interface IAsyncResult

C#

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

Derivato

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

Attributi

ComVisibleAttribute

Esempio

Nell'esempio seguente viene illustrato come usare la AsyncWaitHandle proprietà per ottenere un WaitHandleoggetto e come attendere una chiamata asincrona su un delegato. L'oggetto WaitHandle viene segnalato al completamento della chiamata asincrona ed è possibile attenderlo chiamando il metodo WaitOne .

L'esempio è costituito da due classi: la classe che contiene il metodo chiamato in modo asincrono e la classe che contiene il Main metodo che effettua la chiamata.

Per altre informazioni e altri esempi di chiamata asincrona dei metodi tramite delegati, vedere Chiamata asincrona di metodi sincroni.

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

Commenti

L'interfaccia IAsyncResult viene implementata da classi contenenti metodi che possono funzionare in modo asincrono. Un'operazione asincrona viene iniziata dal tipo restituito dei metodi, ad esempio FileStream.BeginRead, e viene passata ai metodi che concludono un'operazione asincrona, ad esempio FileStream.EndRead. IAsyncResult gli oggetti vengono passati anche ai metodi richiamati dai AsyncCallback delegati al termine di un'operazione asincrona.

Oggetto che supporta l'interfaccia archivia le IAsyncResult informazioni sullo stato per un'operazione asincrona e fornisce un oggetto di sincronizzazione per consentire la segnalazione dei thread al termine dell'operazione.

Nota

La AsyncResult classe è l'implementazione di IAsyncResult restituita dal BeginInvoke metodo quando si usa un delegato per chiamare un metodo in modo asincrono.

Per una descrizione dettagliata del modo in cui viene usata l'interfaccia IAsyncResult , vedere l'argomento Metodi sincroni chiamante in modo asincrono .

Proprietà

AsyncState	Ottiene un oggetto definito dall'utente che qualifica o contiene informazioni sull'operazione asincrona.
AsyncWaitHandle	Ottiene un oggetto WaitHandle che viene usato per attendere il completamento di un'operazione asincrona.
CompletedSynchronously	Valore che indica se l'operazione asincrona. è stata completata in modo sincrono
IsCompleted	Ottiene un valore che indica l'eventuale completamento dell'operazione asincrona.

Si applica a