.NET Framework的IAsyncResult接口的细节

[System.Runtime.InteropServices.ComVisible(true)]
public interface IAsyncResult
{
    object AsyncState { get; }
    WaitHandle AsyncWaitHandle { get; }
    bool CompletedSynchronously { get; }
    bool IsCompleted { get; }
}

using System;
using System.Threading; 

namespace Examples.AdvancedProgramming.AsynchronousOperations
{
    public class AsyncDemo 
    {
        // 将要被异步执行的函数
        public string TestMethod(int callDuration, out int threadId) 
        {
            Console.WriteLine("Test method begins.");
            Thread.Sleep(callDuration); // 被异步执行的函数所在的线程休眠callDuration所指定的时间
            threadId = Thread.CurrentThread.ManagedThreadId; // 拿到系统给本异步执行的函数分配的运行线程的id
            return String.Format("My call time was {0}.", callDuration.ToString());
        }
    }

    // 将要被异步执行的函数的签名声明
    public delegate string AsyncMethodCaller(int callDuration, out int threadId);
}

using System;
using System.Threading;
namespace Examples.AdvancedProgramming.AsynchronousOperations
{
    public class AsyncMain 
    {
        static void Main() 
        {
            int threadId;
            AsyncDemo ad = new AsyncDemo();

            // 创建一个delegate，这个delegate指向AsyncDemo.TestMethod方法
            AsyncMethodCaller caller = new AsyncMethodCaller(ad.TestMethod);
       
            //  这里的BeginInvoke是Delegate的异步调用方法，该方法有以下特性：
            //  a、委托的BeginInvoke方法，在线程池分配的子线程中执行委托
            //  b、委托执行时不会阻塞主线程（调用委托的BeginInvoke线程），主线程继续向下执行。
            //  c、委托执行时会阻塞子线程。
            //  d、委托结束时，如果有返回值，子线程讲返回值传递给主线程；如果有回调函数，子线程
            //     将继续执行回调函数。
            //  参考网页 
            //  https://www.cnblogs.com/EasonLeung/p/3683492.html
            //  https://www.cnblogs.com/markhe/articles/5587956.html
            //  https://www.jb51.net/article/155167.htm

            // 第一个参数就是AsyncMethodCaller函数签名中的int callDuration参数
            // 第二个参数就是AsyncMethodCaller函数签名中的out int threadId参数
            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.
            // 执行本句代码之后，会阻塞当前运行的线程，直到WaitHanle得到赋值为止
            result.AsyncWaitHandle.WaitOne();

            // 参考网址： https://docs.microsoft.com/zh-cn/dotnet/api/system.threading.waithandle.waitone?view=netframework-3.5#System_Threading_WaitHandle_WaitOne
            // WaitHanle得到赋值之后，本线程可以继续执行下去了，要获取到本次delegate调用的回调值，需要
            // 调用EndInvoke方法
            string returnValue = caller.EndInvoke(out threadId, result);

            // 获取完毕之后，关闭wait handle
            result.AsyncWaitHandle.Close();

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