C#中的ManualResetEvent与EventWaitHandle

ManualResetEvent 和 EventWaitHandle 是 .NET 中用于线程同步的类，它们都属于 WaitHandle 的派生类。它们的主要作用是允许一个或多个线程等待某个信号（事件）的发生，从而实现线程间的协调。

1. ManualResetEvent
ManualResetEvent 是一个手动重置的事件对象。它的状态可以是 已发出信号（signaled） 或 未发出信号（non-signaled）。当事件处于 已发出信号 状态时，所有等待该事件的线程都会被释放；当事件处于 未发出信号 状态时，所有等待该事件的线程都会被阻塞。

主要方法
Set()：将事件状态设置为 已发出信号，释放所有等待的线程。

Reset()：将事件状态设置为 未发出信号，阻塞后续等待的线程。

WaitOne()：阻塞当前线程，直到事件状态变为 已发出信号。

示例 1：基本用法

using System;
using System.Threading;

class Program
{
    static ManualResetEvent manualEvent = new ManualResetEvent(false);

    static void Main()
    {
        // 启动一个工作线程
        Thread workerThread = new Thread(DoWork);
        workerThread.Start();

        Console.WriteLine("Main thread is waiting for the worker thread to complete...");
        manualEvent.WaitOne(); // 等待事件发出信号
        Console.WriteLine("Main thread received the signal and continues.");
    }

    static void DoWork()
    {
        Console.WriteLine("Worker thread is doing some work...");
        Thread.Sleep(2000); // 模拟工作
        Console.WriteLine("Worker thread completed the work.");
        manualEvent.Set(); // 发出信号
    }
}

输出：

Main thread is waiting for the worker thread to complete...
Worker thread is doing some work...
Worker thread completed the work.
Main thread received the signal and continues.

示例 2：多个线程等待同一个事件

using System;
using System.Threading;

class Program
{
    static ManualResetEvent manualEvent = new ManualResetEvent(false);

    static void Main()
    {
        for (int i = 0; i < 3; i++)
        {
            Thread thread = new Thread(DoWork);
            thread.Start();
        }

        Console.WriteLine("Main thread is waiting for all worker threads to complete...");
        Thread.Sleep(3000); // 模拟主线程等待
        manualEvent.Set(); // 发出信号，释放所有等待的线程

        Console.WriteLine("Main thread completed.");
    }

    static void DoWork()
    {
        Console.WriteLine($"Thread {Thread.CurrentThread.ManagedThreadId} is waiting...");
        manualEvent.WaitOne(); // 等待事件发出信号
        Console.WriteLine($"Thread {Thread.CurrentThread.ManagedThreadId} received the signal and continues.");
    }
}

输出：

Main thread is waiting for all worker threads to complete...
Thread 3 is waiting...
Thread 4 is waiting...
Thread 5 is waiting...
Main thread completed.
Thread 3 received the signal and continues.
Thread 4 received the signal and continues.
Thread 5 received the signal and continues.

2. EventWaitHandle
EventWaitHandle 是一个更通用的类，可以用于创建 手动重置 或 自动重置 的事件对象。它的行为可以通过构造函数中的 EventResetMode 参数来控制：

EventResetMode.ManualReset：手动重置事件（类似于 ManualResetEvent）。

EventResetMode.AutoReset：自动重置事件（类似于 AutoResetEvent）。

主要方法
Set()：将事件状态设置为 已发出信号。

Reset()：将事件状态设置为 未发出信号。

WaitOne()：阻塞当前线程，直到事件状态变为 已发出信号。

示例 1：手动重置事件

using System;
using System.Threading;

class Program
{
    static EventWaitHandle eventWaitHandle = new EventWaitHandle(false, EventResetMode.ManualReset);

    static void Main()
    {
        Thread workerThread = new Thread(DoWork);
        workerThread.Start();

        Console.WriteLine("Main thread is waiting for the worker thread to complete...");
        eventWaitHandle.WaitOne(); // 等待事件发出信号
        Console.WriteLine("Main thread received the signal and continues.");
    }

    static void DoWork()
    {
        Console.WriteLine("Worker thread is doing some work...");
        Thread.Sleep(2000); // 模拟工作
        Console.WriteLine("Worker thread completed the work.");
        eventWaitHandle.Set(); // 发出信号
    }
}

输出

Main thread is waiting for the worker thread to complete...
Worker thread is doing some work...
Worker thread completed the work.
Main thread received the signal and continues.

示例 2：自动重置事件

using System;
using System.Threading;

class Program
{
    static EventWaitHandle eventWaitHandle = new EventWaitHandle(false, EventResetMode.AutoReset);

    static void Main()
    {
        for (int i = 0; i < 3; i++)
        {
            Thread thread = new Thread(DoWork);
            thread.Start();
        }

        Console.WriteLine("Main thread is waiting for all worker threads to complete...");
        Thread.Sleep(1000); // 模拟主线程等待
        eventWaitHandle.Set(); // 发出信号，释放一个等待的线程
        Thread.Sleep(1000);
        eventWaitHandle.Set(); // 发出信号，释放另一个等待的线程
        Thread.Sleep(1000);
        eventWaitHandle.Set(); // 发出信号，释放最后一个等待的线程

        Console.WriteLine("Main thread completed.");
    }

    static void DoWork()
    {
        Console.WriteLine($"Thread {Thread.CurrentThread.ManagedThreadId} is waiting...");
        eventWaitHandle.WaitOne(); // 等待事件发出信号
        Console.WriteLine($"Thread {Thread.CurrentThread.ManagedThreadId} received the signal and continues.");
    }
}

输出：

Main thread is waiting for all worker threads to complete...
Thread 3 is waiting...
Thread 4 is waiting...
Thread 5 is waiting...
Thread 3 received the signal and continues.
Thread 4 received the signal and continues.
Thread 5 received the signal and continues.
Main thread completed.

3. ManualResetEvent 和 EventWaitHandle 的区别
特性    ManualResetEvent    EventWaitHandle
重置方式    手动重置（需要显式调用 Reset()）    手动重置或自动重置（通过构造函数指定）
适用场景    需要释放所有等待线程的场景    需要更灵活控制的场景
灵活性    较低    较高
4. 总结
ManualResetEvent：适用于需要一次性释放所有等待线程的场景。

EventWaitHandle：更通用，支持手动重置和自动重置，适用于需要更灵活控制的场景。

通过合理使用这些同步工具，可以实现线程间的协调和通信，确保多线程程序的正确性和效率。