SemaphoreSlim 是对可同时访问某一共享资源或资源池的线程数加以限制的 Semaphore 的轻量替代，也可在等待时间预计很短的情况下用于在单个进程内等待。

由于 SemaphoreSlim 更加轻量、快速，因此推荐使用，本文也着重介绍。

一、简介

相较于线程锁的使一块代码只能一个线程访问，SemaphoreSlim 则是让同一块代码让多个线程同时访问，并且总数量可控。

SemaphoreSlim 尽可能多地依赖公共语言运行时 (CLR) 提供的同步基元。 还提供延迟初始化、基于内核的等待句柄。

SemaphoreSlim 也支持使用取消标记，但不支持命名信号量或使用用于同步的等待句柄。

线程通过调用从 WaitHandle 类中继承的 WaitOne 方法进入信号量，无论对于 System.Threading.Semaphore 对象、SemaphoreSlim.Wait 或 SemaphoreSlim.WaitAsync 方法还是 SemaphoreSlim 对象都适用。

当调用返回时，信号量计数会减少，当线程请求进入且计数为零时，此线程受到阻止。 线程通过调用 Semaphore.Release 或 SemaphoreSlim.Release 方法释放信号量时，允许受阻线程进入，此时信号量计数会增加。

受阻线程进入信号量无保证的顺序，比如先进先出 (FIFO) 或按后进先出 (LIFO)。

二、用法示例

关于 SemaphoreSlim、Wait()、Release() 的一个示例。

特别注意：若初始信号量为 0，则需要手动释放（Release()）信号量。

class Program
{
    private static SemaphoreSlim semaphore;
    private static int padding; // 增加固定时间间隔，使输出更有序
    static void Main(string[] args)
    {
        // 创建 semaphore 对象
        semaphore = new SemaphoreSlim(0, 4); // （初始数量，最大数量）
        Console.WriteLine($"semaphore 中现有 {semaphore.CurrentCount} 个信号量");
        Task[] tasks = new Task[10];
        for (int i = 0; i <= 9; i++)
        {
            tasks[i] = Task.Run(() =>
            {
                Console.WriteLine($"任务 {Task.CurrentId} 准备进入 semaphore");
                int semaphoreCount;
                semaphore.Wait(); // 调用 Wait() 方法，标记等待进入信号量
                try
                {
                    Interlocked.Add(ref padding, 100);
                    Console.WriteLine($"任务 {Task.CurrentId} 进入 semaphore");
                    Thread.Sleep(1000 + padding);
                }
                finally
                {
                    semaphoreCount = semaphore.Release(); // 调用 Release() 方法，释放信号量
                    // semaphoreCount：释放当前信号量之前的信号量
                }
                Console.WriteLine($"任务 {Task.CurrentId} 完成，释放 semaphore 一个信号量；释放前信号量：{semaphoreCount}");
            });
        }
        Thread.Sleep(500); // 暂时阻塞主线程，让全部线程到位
        Console.Write("主线程调用 Release(4) 释放四个信号量--> ");
        semaphore.Release(4); // 由于初始数量为 0 所以需要手动释放信号量
        Console.WriteLine($"semaphore 现有信号量 {semaphore.CurrentCount}");
        Task.WaitAll(tasks); // 等待全部线程完成
        Console.WriteLine("主线程退出");
    }
}

输出结果：

  

三、属性 or 函数 or 方法释义

属性-AvailableWaitHandle

  返回一个 WaitHandle 对象，即封装等待对共享资源的独占访问的操作系统对象。

属性-CurrentCount

  指的是对于 SemaphoreSlim 对象，可以输入信号量的剩余线程数。

  属性的初始值 CurrentCount 由对类构造函数的 SemaphoreSlim 调用设置。 每次对 Wait 或 WaitAsync 方法的调用会递减，并按对 Release 方法的每此调用递增。

构造方法-SemaphoreSlim(Int32)

public SemaphoreSlim (int initialCount);

  初始化 SemaphoreSlim 类的新实例，以指定可同时授予的请求的初始数量，但未指定最大请求数。

  若初始数量为 0，则需要手动释放指定数量的信号量；若小于 0，则抛出异常：ArgumentOutOfRangeException。

构造方法-SemaphoreSlim(Int32, Int32)

public SemaphoreSlim (int initialCount, int maxCount);

  初始化 SemaphoreSlim 类的新实例，同时指定可同时授予的请求的初始数量和最大数量。

  若initialCount 小于 0，或 initialCount 大于 maxCount，或 maxCount 小于等于 0，则抛出异常：ArgumentOutOfRangeException。

方法-Dispose

  用于释放由 SemaphoreSlim 类的当前实例使用的所有资源。

  SemaphoreSlim 与大多数成员不同，Dispose 不是线程安全的，不能与此实例的其他成员同时使用。

// 若要释放托管资源和非托管资源，则为 true（缺省默认）；
// 若仅释放非托管资源，则为 false
protected virtual void Dispose (bool disposing);

方法-Release

  对 Release() 方法的调用将属性递增一个 CurrentCount 数。 如果在调用此方法之前 CurrentCount 属性值为零，该方法还允许调用 Wait 或 WaitAsync 方法，阻止一个线程或任务进入信号灯。

// 释放 SemaphoreSlim 对象指定的次数
public int Release (int releaseCount);

方法-Wait

  阻止当前线程，直至它可进入 SemaphoreSlim 对象为止。

// 使用 TimeSpan 来指定超时，同时监视取消动作 CancellationToken
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public bool Wait (TimeSpan timeout, System.Threading.CancellationToken cancellationToken);
// TimeSpan 表示要等待的毫秒数，-1 代表无限等待，0 代表立即返回-测试用例

// 阻止当前线程，直至它可进入 SemaphoreSlim 为止
// 并使用 32 位带符号整数来指定超时（-1 代表无限等待），同时监视取消操作 CancellationToken
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public bool Wait (int millisecondsTimeout, System.Threading.CancellationToken cancellationToken);
// 返回值 bool：如果当前线程成功进入 SemaphoreSlim，则为 true；否则为 false

// 阻止当前线程，直至它可进入 SemaphoreSlim 为止
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public void Wait ();

方法-WaitAsync

  此为 Wait 方法的异步方式，优势在于对线程不会独占，即不会独占当前线程直到释放信号量。

  若将本文第二部分中的代码：（两处修改）

semaphore.Wait();
// 1/2 改为以下，异步方式
semaphore.WaitAsync();

// 2/2 并记录线程 ID（在如下位置添加一行打印信息）
try
{
    Console.WriteLine($"任务 {Task.CurrentId} 进入 semaphore");
    Console.WriteLine($"ProcessorId {Thread.GetCurrentProcessorId()}");// 新增行
    Interlocked.Add(ref padding, 100);
    Thread.Sleep(1000 + padding);
}

  输出的结果：（可见打印出来的线程 ID 有相同的情况，说明并非独占）

  

参考官方：SemaphoreSlim 类

注：个人记录，有问题欢迎指正。

标签：