Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

IAsyncResult, interface

Représente l'état d'une opération asynchrone.

Espace de noms :  System
Assembly :  mscorlib (dans mscorlib.dll)

[ComVisibleAttribute(true)]
public interface IAsyncResult

Le type IAsyncResult expose les membres suivants.

  NomDescription
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreAsyncStateObtient un objet défini par l'utilisateur qui qualifie ou qui contient des informations sur une opération asynchrone.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreAsyncWaitHandleObtient WaitHandle utilisé pour attendre qu'une opération asynchrone se termine.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCompletedSynchronouslyObtient une valeur qui indique si l'opération asynchrone a été terminée de manière synchrone.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreIsCompletedObtient une valeur qui indique si l'opération asynchrone est terminée.
Début

L'interface IAsyncResult est implémentée par des classes contenant des méthodes qui peuvent opérer de manière asynchrone. Type de retour de méthodes qui initialisent une opération asynchrone, par exemple FileStream.BeginRead, et il est passé aux méthodes qui se terminent une opération asynchrone, par exemple FileStream.EndRead. Des objets IAsyncResult sont également passés aux méthodes appelées par des délégués AsyncCallback à la fin d'une opération asynchrone.

Un objet qui prend en charge l'interface IAsyncResult stocke les informations d'état pour une opération asynchrone et fournit un objet de synchronisation permettant aux threads d'être notifiés une fois l'opération terminée.

RemarqueRemarque

La classe AsyncResult est l'implémentation du IAsyncResult qui est retourné par la méthode BeginInvoke lorsque vous utilisez un délégué pour appeler une méthode de façon asynchrone.

Pour obtenir une description détaillée de la manière dont l'interface IAsyncResult est utilisée, consultez la rubrique Appel de méthodes synchrones de façon asynchrone.

L'exemple suivant montre comment utiliser la propriété AsyncWaitHandle pour obtenir un WaitHandle et comment attendre un appel asynchrone sur un délégué. Le WaitHandle est signalé lorsque l'appel asynchrone se termine et vous pouvez l'attendre en appelant la méthode WaitOne.

L'exemple se compose de deux classes : la classe contenant la méthode qui est appelée de façon asynchrone et la classe contenant la méthode Main qui effectue l'appel.

Pour plus d'informations et pour obtenir d'autres exemples d'appel de méthodes asynchrone à l'aide de délégués, consultez Appel de méthodes synchrones de façon asynchrone.


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


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft