ThreadPool使用

以下三个代码示例演示 QueueUserWorkItem 和 RegisterWaitForSingleObject 方法。

第一个示例使用 QueueUserWorkItem 方法将一个由 ThreadProc 方法表示的非常简单的任务排入队列。

using System;
using System.Threading;
public class Example {
     public static void Main() {
         // 将任务排队
         ThreadPool.QueueUserWorkItem(new WaitCallback(ThreadProc));
        
         Console.WriteLine("Main thread does some work, then sleeps.");
         // 如果你注释掉这个Sleep, 而线程池使用后台线程，
          // 那么主线程将会停止运行，并在线程池任务运行之前退出
          // (这是一个简单的线程池运行环境例子)
         Thread.Sleep(1000);
         Console.WriteLine("Main thread exits.");
     }
     // 这是执行任务的线程子程序
     static void ThreadProc(Object stateInfo) {
         // 没有state对象被传递到QueueUserWorkItem, 所以
         // stateInfo是null.
         Console.WriteLine("Hello from the thread pool.");
     }
}

为 QueueUserWorkItem 提供任务数据
下面的代码示例使用 QueueUserWorkItem 方法将一个任务排队并为该任务提供数据。

using System;
using System.Threading;
// TaskInfo 类 为任务提供将在线程池线程中执行的 state 信息
public class TaskInfo {
     // 任务所需的State信息，这些类成员可以是任务需要的确定的只读属性，
     // 可读写属性，或者其它。 
     public string Boilerplate;
     public int Value;
     // Public 构造函数提供一个非常简单途径用来接收任务所需要的信息
     public TaskInfo(string text, int number) {
         Boilerplate = text;
         Value = number;
     }
}
public class Example {
     public static void Main() {
         // 创建一个包含任务所需要信息的对象。
         TaskInfo ti = new TaskInfo("This report displays the number {0}.", 42);
         // 将任务排队并传入所需信息
         if (ThreadPool.QueueUserWorkItem(new WaitCallback(ThreadProc), ti)) {    
             Console.WriteLine("Main thread does some work, then sleeps.");
             // 如果你注释掉这个Sleep, 而线程池使用后台线程，
               // 那么主线程将会停止运行，并在线程池任务有机会运行之前退出
               // (这是一个简单的线程池运行环境例子)
             Thread.Sleep(1000);
             Console.WriteLine("Main thread exits.");
         }
         else {
             Console.WriteLine("Unable to queue ThreadPool request."); 
         }
     }
     // 这个线程子程序执行独立的任务，在这里转换并打印一个非常简单的报告
     static void ThreadProc(Object stateInfo) {
         TaskInfo ti = (TaskInfo) stateInfo;
         Console.WriteLine(ti.Boilerplate, ti.Value); 
     }
}

RegisterWaitForSingleObject
下面的示例演示几种线程处理功能。
· 使用 RegisterWaitForSingleObject 方法将任务排队，以由 ThreadPool 线程执行。
· 使用 AutoResetEvent 发出信号，通知执行任务。请参见 EventWaitHandle、AutoResetEvent 和 ManualResetEvent。
· 使用 WaitOrTimerCallback 委托处理超时和信号。
· 使用 RegisteredWaitHandle 取消排入队列的任务。
using System;
using System.Threading;
// TaskInfo 包含将要被回调（callback）的数据
public class TaskInfo {
     public RegisteredWaitHandle Handle = null;
     public string OtherInfo = "default";
}
public class Example {
     public static void Main(string[] args) {
         // 主线程使用 AutoResetEvent 通知执行回调方法的 wait 句柄（handle）
         AutoResetEvent ev = new AutoResetEvent(false);
         TaskInfo ti = new TaskInfo();
         ti.OtherInfo = "First task";
         // TaskInfo对象包含了为任务返回RegisterWaitForSingleObject的注册等待句柄（handle） 
         // 这允许当对象一旦被通知就终止等待操作。(见 WaitProc).
         ti.Handle = ThreadPool.RegisterWaitForSingleObject(
             ev,
             new WaitOrTimerCallback(WaitProc),
             ti,
             1000,
             false
         );
         // 主线程等待三秒钟，用以示范排队线程超时的情况，然后通知它。
         Thread.Sleep(3100);
         Console.WriteLine("Main thread signals.");
         ev.Set();
         // 主线程休眠（sleeps），应该能给回调（callback）方法足够的时候去执行它。
         // 如果你注释掉这行，程序通常会在线程池线程被执行前退出。
         Thread.Sleep(1000);
         // 如果你开始一个自己的线程，你可以调用 Thread.Join() 来等待它完成。
         // 这个选项在线程池线程里不可用。
     }
   
     // 当注册等待超时，或者当等待句柄（WaitHandle——在这个例子里是AutoResetEvent）被通知时，
     // 将会执行这个回调（callback）方法，
     // WaitProc 反注册等待句柄（WaitHandle） the first time the event is 
     // signaled.
     public static void WaitProc(object state, bool timedOut) {
         // state 对象必须传入正确的类型，因为 WaitOrTimerCallback 委托（delegate）
         // 明确指出的对象的类型。
         TaskInfo ti = (TaskInfo) state;
         string cause = "TIMED OUT";
         if (!timedOut) {
             cause = "SIGNALED";
             // 如果这个回调（callback）方法被执行是因为等待句柄（WaitHandle）通知，
             // 停止执行接下来的回调（callback ）方法, 并反注册等待句柄（WaitHandle） 
             if (ti.Handle != null)
                 ti.Handle.Unregister(null);
         }
         Console.WriteLine("WaitProc( {0} ) executes on thread {1}; cause = {2}.",
             ti.OtherInfo, 
             Thread.CurrentThread.GetHashCode().ToString(), 
             cause
         );
     }
}