IAsyncResult.IsCompleted Tulajdonság

public:
 property bool IsCompleted { bool get(); };

public bool IsCompleted { get; }

member this.IsCompleted : bool

Public ReadOnly Property IsCompleted As Boolean

Tulajdonság értéke

trueha a művelet befejeződött; egyéb esetben. false

Példák

Az alábbi példa bemutatja, hogyan derítheti fel, IsCompletedIAsyncResult hogy mikor fejeződik be egy aszinkron hívás. Ebben az esetben az aszinkron hívás egy meghatalmazott metódusával történik BeginInvoke . A tulajdonság használatával lekérdezheti a IsCompleted befejezést, amikor a felhasználói felületet kiszolgáló szál aszinkron hívását kezdeményezi. A befejezési lekérdezés lehetővé teszi, hogy a hívó szál folytassa a végrehajtást, miközben az aszinkron hívás egy ThreadPool szálon fut.

A példa két osztályból áll: az aszinkron metódust tartalmazó osztályból és a hívást kezdeményező metódust tartalmazó Main osztályból.

További információkért és a meghatalmazottak használatával aszinkron hívási módszerekre vonatkozó további példákért lásd: Szinkron metódusok aszinkron hívása.

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);
}

Imports System.Threading
Imports System.Runtime.InteropServices 

Namespace Examples.AdvancedProgramming.AsynchronousOperations
    Public Class AsyncDemo 
        ' The method to be executed asynchronously.
        Public Function TestMethod(ByVal callDuration As Integer, _
                <Out> ByRef threadId As Integer) As String
            Console.WriteLine("Test method begins.")
            Thread.Sleep(callDuration)
            threadId = Thread.CurrentThread.ManagedThreadId()
            return String.Format("My call time was {0}.", callDuration.ToString())
        End Function
    End Class

    ' The delegate must have the same signature as the method
    ' it will call asynchronously.
    Public Delegate Function AsyncMethodCaller(ByVal callDuration As Integer, _
        <Out> ByRef threadId As Integer) As String
End Namespace

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);

            // Poll while simulating work.
            while(!result.IsCompleted) {
                Thread.Sleep(250);
                Console.Write(".");
            }

            // Call EndInvoke to retrieve the results.
            string returnValue = caller.EndInvoke(out threadId, result);

            Console.WriteLine("\nThe call executed on thread {0}, with return value \"{1}\".",
                threadId, returnValue);
        }
    }
}

/* This example produces output similar to the following:

Test method begins.
.............
The call executed on thread 3, with return value "My call time was 3000.".
 */

Imports System.Threading
Imports System.Runtime.InteropServices 

Namespace Examples.AdvancedProgramming.AsynchronousOperations

    Public Class AsyncMain 
        Shared Sub Main() 
            ' The asynchronous method puts the thread id here.
            Dim threadId As Integer

            ' Create an instance of the test class.
            Dim ad As New AsyncDemo()

            ' Create the delegate.
            Dim caller As New AsyncMethodCaller(AddressOf ad.TestMethod)
       
            ' Initiate the asynchronous call.
            Dim result As IAsyncResult = caller.BeginInvoke(3000, _
                threadId, Nothing, Nothing)

            ' Poll while simulating work.
            While result.IsCompleted = False
                Thread.Sleep(250)
                Console.Write(".")
            End While

            ' Call EndInvoke to retrieve the results.
            Dim returnValue As String = caller.EndInvoke(threadId, result)

            Console.WriteLine(vbCrLf & _
                "The call executed on thread {0}, with return value ""{1}"".", _
                threadId, returnValue)
        End Sub
    End Class
End Namespace

' This example produces output similar to the following:
'
'Test method begins.
'.............
'The call executed on thread 3, with return value "My call time was 3000.".

Megjegyzések

Ha ez a tulajdonság, truefeltételezheti, hogy az aszinkron művelet által használt összes erőforrást nyugodtan elvetheti.

Megjegyzések az implementálókhoz

A implementátorok általában egy magánmező vagy belső teszt értékét adja vissza ennek a tulajdonságnak az értékeként.

Megjegyzések a hívókhoz

A művelet állapotát lekérdező ügyfelek (a szinkronizálási objektumokra való várakozás helyett) ezt a tulajdonságot használják a művelet állapotának meghatározásához.