沒有找到您要找的內容嗎？
資訊圖標
跳至頁尾內容
  1. IronPDF
  2. IronPDF 部落格
  3. .NET 幫助
  4. C# Semaphoreslim
.NET幫助

C# SemaphoreSlim（對開發者如何理解的工作）

Jacob Mellor，首席技術官 @ Team Iron
Jacob Mellor
已更新:

並發管理是C#高效能應用程式中的關鍵方面。 它確保資源被高效利用，同時避免潛在衝突或性能瓶頸，因此擁有一個輕量級的信號量來控制存取非常有幫助。 這就是SemaphoreSlim派上用場的地方。 SemaphoreSlim 是一個輕量級的同步原語，可以控制資源存取，最終避免競賽條件並確保執行緒安全。

那麼，如果您想將其與 PDF 程式庫一起實現以管理 PDF 生成過程呢？ 您可能正在尋找一個強大的 PDF 程式庫，這就是IronPDF的用武之地。 IronPDF 是一個強大的 PDF 生成和操作程式庫，專為.NET開發者設計，在多執行緒環境中使用時可以從並發管理中獲益良多。

如果您想了解 SemaphoreSlim 和 IronPDF 的實際應用，請繼續閱讀，我們將探討使用 SemaphoreSlim 的優勢以及如何將其與 IronPDF 整合以安全處理並發操作，提高性能並確保可靠的 PDF 處理。

Understanding SemaphoreSlim in C

什麼是SemaphoreSlim？

SemaphoreSlim 是.NET中的一種同步原語，用於限制能夠同時存取特定資源或資源池的執行緒數量。 它是完整 Semaphore 類別的輕量版本，旨在為需要更簡單、更快的信號量的情況提供更高效的解決方案。 using SemaphoreSlim 的一些好處是與 Semaphore 相比，系統開銷減少了，它非常適合管理有限資源（例如資料庫連接或文件存取），並且支持異步等待方法，使其非常適合現代非同步/等待程式設計模式。

基本 SemaphoreSlim 用法程式碼範例

using System;
using System.Threading;
using System.Threading.Tasks;

class Program
{
    // Semaphore count
    private static SemaphoreSlim _semaphore = new SemaphoreSlim(3); // Limit to 3 concurrent threads.

    static async Task Main(string[] args)
    {
        // Start tasks that will wait on the semaphore.
        var tasks = new Task[5];

        for (int i = 0; i < tasks.Length; i++)
        {
            tasks[i] = Task.Run(() => AccessResource(i));
        }

        // Simulate some work in the main thread (e.g., initialization).
        Console.WriteLine("Main thread is preparing resources...");
        await Task.Delay(2000);  // Simulate initialization delay.

        // Main thread calls release, releases semaphore permits to allow waiting tasks to proceed.
        Console.WriteLine("Main thread releasing semaphore permits...");
        _semaphore.Release(2);  // Releases 2 permits, allowing up to 2 tasks to proceed.

        // Wait for all tasks to complete.
        await Task.WhenAll(tasks);
        Console.WriteLine("All tasks completed.");
    }

    static async Task AccessResource(int id)
    {
        Console.WriteLine($"Task {id} waiting to enter...");
        await _semaphore.WaitAsync();

        try
        {
            Console.WriteLine($"Current thread successfully entered by Task {id}.");
            await Task.Delay(1000); // Simulate work.
        }
        finally
        {
            Console.WriteLine($"Task {id} releasing.");
            _semaphore.Release();
        }
    }
}
using System;
using System.Threading;
using System.Threading.Tasks;

class Program
{
    // Semaphore count
    private static SemaphoreSlim _semaphore = new SemaphoreSlim(3); // Limit to 3 concurrent threads.

    static async Task Main(string[] args)
    {
        // Start tasks that will wait on the semaphore.
        var tasks = new Task[5];

        for (int i = 0; i < tasks.Length; i++)
        {
            tasks[i] = Task.Run(() => AccessResource(i));
        }

        // Simulate some work in the main thread (e.g., initialization).
        Console.WriteLine("Main thread is preparing resources...");
        await Task.Delay(2000);  // Simulate initialization delay.

        // Main thread calls release, releases semaphore permits to allow waiting tasks to proceed.
        Console.WriteLine("Main thread releasing semaphore permits...");
        _semaphore.Release(2);  // Releases 2 permits, allowing up to 2 tasks to proceed.

        // Wait for all tasks to complete.
        await Task.WhenAll(tasks);
        Console.WriteLine("All tasks completed.");
    }

    static async Task AccessResource(int id)
    {
        Console.WriteLine($"Task {id} waiting to enter...");
        await _semaphore.WaitAsync();

        try
        {
            Console.WriteLine($"Current thread successfully entered by Task {id}.");
            await Task.Delay(1000); // Simulate work.
        }
        finally
        {
            Console.WriteLine($"Task {id} releasing.");
            _semaphore.Release();
        }
    }
}
Imports System
Imports System.Threading
Imports System.Threading.Tasks

Friend Class Program
	' Semaphore count
	Private Shared _semaphore As New SemaphoreSlim(3) ' Limit to 3 concurrent threads.

	Shared Async Function Main(ByVal args() As String) As Task
		' Start tasks that will wait on the semaphore.
		Dim tasks = New Task(4){}

		For i As Integer = 0 To tasks.Length - 1
			tasks(i) = Task.Run(Function() AccessResource(i))
		Next i

		' Simulate some work in the main thread (e.g., initialization).
		Console.WriteLine("Main thread is preparing resources...")
		Await Task.Delay(2000) ' Simulate initialization delay.

		' Main thread calls release, releases semaphore permits to allow waiting tasks to proceed.
		Console.WriteLine("Main thread releasing semaphore permits...")
		_semaphore.Release(2) ' Releases 2 permits, allowing up to 2 tasks to proceed.

		' Wait for all tasks to complete.
		Await Task.WhenAll(tasks)
		Console.WriteLine("All tasks completed.")
	End Function

	Private Shared Async Function AccessResource(ByVal id As Integer) As Task
		Console.WriteLine($"Task {id} waiting to enter...")
		Await _semaphore.WaitAsync()

		Try
			Console.WriteLine($"Current thread successfully entered by Task {id}.")
			Await Task.Delay(1000) ' Simulate work.
		Finally
			Console.WriteLine($"Task {id} releasing.")
			_semaphore.Release()
		End Try
	End Function
End Class
$vbLabelText   $csharpLabel

在程式運行過程中，當所有可用許可證都被執行緒獲得時，信號量的計數可以動態地達到零執行緒。 這種狀態表明達到了允許的最大同時存取量。

如果您願意，您可以設置適當的初始和最大執行緒數，將信號量的初始計數設為零，然後使用單獨的初始化任務來增加資源準備就緒時的信號量計數，允許您選擇的執行緒數繼續。 當信號量計數為零時，執行緒將在嘗試進入信號量時等待，這被稱為"阻塞等待"。

您可以通過跟蹤此前的信號量計數來調整信號量行為。 然後可以根據需要操控信號量（例如，通過釋放或等待）。 隨著執行緒釋放，信號量計數減少。

控制台輸出

C# Semaphoreslim（它如何為開發人員工作）：圖1

SemaphoreSlim 的常見使用場景

SemaphoreSlim 的一些常見使用場景包括：

  • 限制對資料庫或文件系統的存取：它防止這些資源因過多的並發請求而不堪重負。
  • 管理執行緒池：它可以用來控制執行特定操作的執行緒數，從而提高穩定性和性能。

將 SemaphoreSlim 與 IronPDF 結合以控制並發性

在多執行緒環境中設置 IronPDF

要開始在多執行緒環境中使用 IronPDF，首先從IronPDF NuGet 套件進行安裝。 您可以通過導航至工具 > NuGet 套件管理器 > 整個方案的 NuGet 套件管理器並搜尋 IronPDF 來完成此操作：

C# Semaphoreslim（它如何為開發人員工作）：圖2

或者，另可在套件管理器控制台中運行以下命令：

Install-Package IronPdf

要在您的程式碼中開始使用 IronPDF，請確保您已將 using IronPdf 語句放置於程式碼文件的頂部。若需更詳盡的 IronPDF 環境設置指南，請查看其快速入門頁面。

使用 SemaphoreSlim 控制 PDF 生成存取

當您使用 SemaphoreSlim 時，您可以有效地控制對 PDF 生成任務的存取。 這確保您的應用程式不會嘗試同時生成過多的 PDF，這可能影響性能或導致故障。

以下範例程式碼展示了 SemaphoreSlim 與 IronPDF 的基本用法。

using IronPdf;
using System;
using System.Threading;
using System.Threading.Tasks;

class Program
{
    private static SemaphoreSlim _semaphore = new SemaphoreSlim(2); // Limit to 2 concurrent threads.

    static async Task Main(string[] args)
    {
        var tasks = new Task[5];

        for (int i = 0; i < tasks.Length; i++)
        {
            string htmlContent = $"<h1>PDF Document {i}</h1><p>This is a sample PDF content for task {i}.</p>";
            string outputPath = $"output_{i}.pdf";

            // Start multiple tasks to demonstrate controlled concurrency.
            tasks[i] = GeneratePdfAsync(htmlContent, outputPath, i);
        }

        await Task.WhenAll(tasks);
    }

    static async Task GeneratePdfAsync(string htmlContent, string outputPath, int taskId)
    {
        Console.WriteLine($"Task {taskId} is waiting for access...");

        // Wait to enter the semaphore.
        await _semaphore.WaitAsync();

        try
        {
            Console.WriteLine($"Task {taskId} has started PDF generation.");
            ChromePdfRenderer renderer = new ChromePdfRenderer();
            PdfDocument pdf = await renderer.RenderHtmlAsPdfAsync(htmlContent);
            pdf.SaveAs(outputPath);
            Console.WriteLine($"Task {taskId} has completed PDF generation.");
        }
        finally
        {
            // Ensure semaphore is released to allow other tasks to proceed.
            _semaphore.Release();
            Console.WriteLine($"Task {taskId} has released semaphore.");
        }
    }
}
using IronPdf;
using System;
using System.Threading;
using System.Threading.Tasks;

class Program
{
    private static SemaphoreSlim _semaphore = new SemaphoreSlim(2); // Limit to 2 concurrent threads.

    static async Task Main(string[] args)
    {
        var tasks = new Task[5];

        for (int i = 0; i < tasks.Length; i++)
        {
            string htmlContent = $"<h1>PDF Document {i}</h1><p>This is a sample PDF content for task {i}.</p>";
            string outputPath = $"output_{i}.pdf";

            // Start multiple tasks to demonstrate controlled concurrency.
            tasks[i] = GeneratePdfAsync(htmlContent, outputPath, i);
        }

        await Task.WhenAll(tasks);
    }

    static async Task GeneratePdfAsync(string htmlContent, string outputPath, int taskId)
    {
        Console.WriteLine($"Task {taskId} is waiting for access...");

        // Wait to enter the semaphore.
        await _semaphore.WaitAsync();

        try
        {
            Console.WriteLine($"Task {taskId} has started PDF generation.");
            ChromePdfRenderer renderer = new ChromePdfRenderer();
            PdfDocument pdf = await renderer.RenderHtmlAsPdfAsync(htmlContent);
            pdf.SaveAs(outputPath);
            Console.WriteLine($"Task {taskId} has completed PDF generation.");
        }
        finally
        {
            // Ensure semaphore is released to allow other tasks to proceed.
            _semaphore.Release();
            Console.WriteLine($"Task {taskId} has released semaphore.");
        }
    }
}
Imports IronPdf
Imports System
Imports System.Threading
Imports System.Threading.Tasks

Friend Class Program
	Private Shared _semaphore As New SemaphoreSlim(2) ' Limit to 2 concurrent threads.

	Shared Async Function Main(ByVal args() As String) As Task
		Dim tasks = New Task(4){}

		For i As Integer = 0 To tasks.Length - 1
			Dim htmlContent As String = $"<h1>PDF Document {i}</h1><p>This is a sample PDF content for task {i}.</p>"
			Dim outputPath As String = $"output_{i}.pdf"

			' Start multiple tasks to demonstrate controlled concurrency.
			tasks(i) = GeneratePdfAsync(htmlContent, outputPath, i)
		Next i

		Await Task.WhenAll(tasks)
	End Function

	Private Shared Async Function GeneratePdfAsync(ByVal htmlContent As String, ByVal outputPath As String, ByVal taskId As Integer) As Task
		Console.WriteLine($"Task {taskId} is waiting for access...")

		' Wait to enter the semaphore.
		Await _semaphore.WaitAsync()

		Try
			Console.WriteLine($"Task {taskId} has started PDF generation.")
			Dim renderer As New ChromePdfRenderer()
			Dim pdf As PdfDocument = Await renderer.RenderHtmlAsPdfAsync(htmlContent)
			pdf.SaveAs(outputPath)
			Console.WriteLine($"Task {taskId} has completed PDF generation.")
		Finally
			' Ensure semaphore is released to allow other tasks to proceed.
			_semaphore.Release()
			Console.WriteLine($"Task {taskId} has released semaphore.")
		End Try
	End Function
End Class
$vbLabelText   $csharpLabel

在此範例中，我們首先初始化了 SemaphoreSlim，並將之的初始和最大計數設為 '2'，將同時生成的 PDF 限制為兩份。 然後我們建立了一個任務陣列，用於控制程式需執行的任務數量，之後我們使用 for 迴圈來動態建立 PDFs，基於任務陣列中的任務數量。

然後使用 WaitAsync() 方法進入信號量，並在 finally 區塊中使用 Release() 確保即便發生異常，信號量始終被釋放。 控制台輸出日誌顯示了每個任務開始、完成和釋放信號量的時間，這使您能夠跟踪並發行為。

輸出控制台

C# Semaphoreslim（它如何為開發人員工作）：圖3

輸出PDF文件

C# Semaphoreslim（它如何為開發人員工作）：圖4

確保 PDF 操作任務中的執行緒安全

當多個執行緒與共享資源交互時，執行緒安全是至關重要的。 在 PDF 操作中，SemaphoreSlim 確保只有指定數量的執行緒可同時修改 PDF，從而避免競賽條件並確保一致性。 在以下程式碼中，我們模擬了一個場景，即我們正在新增水印到多個PDF中，同時確保一次只有一個操作進行。

using IronPdf;
using System;
using System.Threading;
using System.Threading.Tasks;

class Program
{
    private static SemaphoreSlim _semaphore = new SemaphoreSlim(1);

    static async Task Main(string[] args)
    {
        // Setting array of tasks
        var tasks = new Task[3];

        for (int i = 0; i < tasks.Length; i++)
        {
            string inputPath = $"input_{i}.pdf";  // Input PDF file path
            string outputPath = $"output_{i}.pdf";  // Output PDF file path
            string watermarkText = @"
<img src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>
<h1>Iron Software</h1>";

            // Start multiple tasks to add watermarks concurrently.
            tasks[i] = AddWatermarkAsync(inputPath, outputPath, watermarkText, i);
        }

        await Task.WhenAll(tasks); // Wait for all tasks to finish.
    }

    static async Task AddWatermarkAsync(string input, string outputPath, string watermark, int taskId)
    {
        Console.WriteLine($"{DateTime.Now:HH:mm:ss} - Task {taskId} is waiting to add a watermark...");

        // Wait to enter the semaphore.
        await _semaphore.WaitAsync();

        try
        {
            Console.WriteLine($"{DateTime.Now:HH:mm:ss} - Task {taskId} is adding a watermark.");
            var pdf = PdfDocument.FromFile(input);
            pdf.ApplyWatermark(watermark); // Add watermark
            pdf.SaveAs(outputPath); // Save the modified PDF
            Console.WriteLine($"{DateTime.Now:HH:mm:ss} - Task {taskId} has completed watermarking.");
        }
        finally
        {
            // Release the semaphore after the task is done.
            _semaphore.Release();
            Console.WriteLine($"{DateTime.Now:HH:mm:ss} - Task {taskId} has released semaphore.");
        }
    }
}
using IronPdf;
using System;
using System.Threading;
using System.Threading.Tasks;

class Program
{
    private static SemaphoreSlim _semaphore = new SemaphoreSlim(1);

    static async Task Main(string[] args)
    {
        // Setting array of tasks
        var tasks = new Task[3];

        for (int i = 0; i < tasks.Length; i++)
        {
            string inputPath = $"input_{i}.pdf";  // Input PDF file path
            string outputPath = $"output_{i}.pdf";  // Output PDF file path
            string watermarkText = @"
<img src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>
<h1>Iron Software</h1>";

            // Start multiple tasks to add watermarks concurrently.
            tasks[i] = AddWatermarkAsync(inputPath, outputPath, watermarkText, i);
        }

        await Task.WhenAll(tasks); // Wait for all tasks to finish.
    }

    static async Task AddWatermarkAsync(string input, string outputPath, string watermark, int taskId)
    {
        Console.WriteLine($"{DateTime.Now:HH:mm:ss} - Task {taskId} is waiting to add a watermark...");

        // Wait to enter the semaphore.
        await _semaphore.WaitAsync();

        try
        {
            Console.WriteLine($"{DateTime.Now:HH:mm:ss} - Task {taskId} is adding a watermark.");
            var pdf = PdfDocument.FromFile(input);
            pdf.ApplyWatermark(watermark); // Add watermark
            pdf.SaveAs(outputPath); // Save the modified PDF
            Console.WriteLine($"{DateTime.Now:HH:mm:ss} - Task {taskId} has completed watermarking.");
        }
        finally
        {
            // Release the semaphore after the task is done.
            _semaphore.Release();
            Console.WriteLine($"{DateTime.Now:HH:mm:ss} - Task {taskId} has released semaphore.");
        }
    }
}
Imports IronPdf
Imports System
Imports System.Threading
Imports System.Threading.Tasks

Friend Class Program
	Private Shared _semaphore As New SemaphoreSlim(1)

	Shared Async Function Main(ByVal args() As String) As Task
		' Setting array of tasks
		Dim tasks = New Task(2){}

		For i As Integer = 0 To tasks.Length - 1
			Dim inputPath As String = $"input_{i}.pdf" ' Input PDF file path
			Dim outputPath As String = $"output_{i}.pdf" ' Output PDF file path
			Dim watermarkText As String = "
<img src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>
<h1>Iron Software</h1>"

			' Start multiple tasks to add watermarks concurrently.
			tasks(i) = AddWatermarkAsync(inputPath, outputPath, watermarkText, i)
		Next i

		Await Task.WhenAll(tasks) ' Wait for all tasks to finish.
	End Function

	Private Shared Async Function AddWatermarkAsync(ByVal input As String, ByVal outputPath As String, ByVal watermark As String, ByVal taskId As Integer) As Task
		Console.WriteLine($"{DateTime.Now:HH:mm:ss} - Task {taskId} is waiting to add a watermark...")

		' Wait to enter the semaphore.
		Await _semaphore.WaitAsync()

		Try
			Console.WriteLine($"{DateTime.Now:HH:mm:ss} - Task {taskId} is adding a watermark.")
			Dim pdf = PdfDocument.FromFile(input)
			pdf.ApplyWatermark(watermark) ' Add watermark
			pdf.SaveAs(outputPath) ' Save the modified PDF
			Console.WriteLine($"{DateTime.Now:HH:mm:ss} - Task {taskId} has completed watermarking.")
		Finally
			' Release the semaphore after the task is done.
			_semaphore.Release()
			Console.WriteLine($"{DateTime.Now:HH:mm:ss} - Task {taskId} has released semaphore.")
		End Try
	End Function
End Class
$vbLabelText   $csharpLabel

我們將信號量計數設為1，使用 private static SemaphoreSlim _semaphore = new SemaphoreSlim(1); 確保一次只有一個任務可以操作PDF。

控制台輸出

C# Semaphoreslim（它如何為開發人員工作）：圖5

透過 SemaphoreSlim 和 IronPDF 優化性能

管理資源密集型操作

IronPDF 在處理資源密集型任務方面表現卓越，例如將大型 HTML 文件轉換為 PDF，並在非同步環境下執行這些任務時尤為出色。 使用 SemaphoreSlim 來管理這些操作可確保您的應用程式在承受重負載時保持響應性和性能。

以下範例程式碼演示了一個場景，當我們需要限制同時進行的大型 HTML 到 PDF 轉換數量以免系統資源不堪重負。

using IronPdf;
using System;
using System.Threading;
using System.Threading.Tasks;

class Program
{
    // Limit concurrent large PDF conversions to 2.
    private static SemaphoreSlim _semaphore = new SemaphoreSlim(2);

    static async Task Main(string[] args)
    {
        var tasks = new Task[4];

        for (int i = 0; i < tasks.Length; i++)
        {
            string htmlContent = $"<h1>Large Document {i}</h1><p>Content for a large HTML file {i}.</p>";
            string outputPath = $"large_output_{i}.pdf";

            // Start multiple tasks to convert large HTML files to PDFs.
            tasks[i] = ConvertLargeHtmlAsync(htmlContent, outputPath, i);
        }

        await Task.WhenAll(tasks); // Wait for all tasks to finish.
    }

    // Method to convert large HTML to PDF using SemaphoreSlim to control resource usage.
    public static async Task ConvertLargeHtmlAsync(string htmlContent, string outputPath, int taskId)
    {
        Console.WriteLine($"Task {taskId} is waiting to start conversion...");

        // Wait to enter the semaphore.
        await _semaphore.WaitAsync();

        try
        {
            Console.WriteLine($"Task {taskId} is converting large HTML to PDF.");
            var renderer = new ChromePdfRenderer();
            var pdf = await renderer.RenderHtmlAsPdfAsync(htmlContent); // Convert large HTML to PDF
            pdf.SaveAs(outputPath); // Save the PDF file
            Console.WriteLine($"Task {taskId} has completed conversion.");
        }
        finally
        {
            // Ensure the semaphore is released to allow other tasks to proceed.
            _semaphore.Release();
            Console.WriteLine($"Task {taskId} has released semaphore.");
        }
    }
}
using IronPdf;
using System;
using System.Threading;
using System.Threading.Tasks;

class Program
{
    // Limit concurrent large PDF conversions to 2.
    private static SemaphoreSlim _semaphore = new SemaphoreSlim(2);

    static async Task Main(string[] args)
    {
        var tasks = new Task[4];

        for (int i = 0; i < tasks.Length; i++)
        {
            string htmlContent = $"<h1>Large Document {i}</h1><p>Content for a large HTML file {i}.</p>";
            string outputPath = $"large_output_{i}.pdf";

            // Start multiple tasks to convert large HTML files to PDFs.
            tasks[i] = ConvertLargeHtmlAsync(htmlContent, outputPath, i);
        }

        await Task.WhenAll(tasks); // Wait for all tasks to finish.
    }

    // Method to convert large HTML to PDF using SemaphoreSlim to control resource usage.
    public static async Task ConvertLargeHtmlAsync(string htmlContent, string outputPath, int taskId)
    {
        Console.WriteLine($"Task {taskId} is waiting to start conversion...");

        // Wait to enter the semaphore.
        await _semaphore.WaitAsync();

        try
        {
            Console.WriteLine($"Task {taskId} is converting large HTML to PDF.");
            var renderer = new ChromePdfRenderer();
            var pdf = await renderer.RenderHtmlAsPdfAsync(htmlContent); // Convert large HTML to PDF
            pdf.SaveAs(outputPath); // Save the PDF file
            Console.WriteLine($"Task {taskId} has completed conversion.");
        }
        finally
        {
            // Ensure the semaphore is released to allow other tasks to proceed.
            _semaphore.Release();
            Console.WriteLine($"Task {taskId} has released semaphore.");
        }
    }
}
Imports IronPdf
Imports System
Imports System.Threading
Imports System.Threading.Tasks

Friend Class Program
	' Limit concurrent large PDF conversions to 2.
	Private Shared _semaphore As New SemaphoreSlim(2)

	Shared Async Function Main(ByVal args() As String) As Task
		Dim tasks = New Task(3){}

		For i As Integer = 0 To tasks.Length - 1
			Dim htmlContent As String = $"<h1>Large Document {i}</h1><p>Content for a large HTML file {i}.</p>"
			Dim outputPath As String = $"large_output_{i}.pdf"

			' Start multiple tasks to convert large HTML files to PDFs.
			tasks(i) = ConvertLargeHtmlAsync(htmlContent, outputPath, i)
		Next i

		Await Task.WhenAll(tasks) ' Wait for all tasks to finish.
	End Function

	' Method to convert large HTML to PDF using SemaphoreSlim to control resource usage.
	Public Shared Async Function ConvertLargeHtmlAsync(ByVal htmlContent As String, ByVal outputPath As String, ByVal taskId As Integer) As Task
		Console.WriteLine($"Task {taskId} is waiting to start conversion...")

		' Wait to enter the semaphore.
		Await _semaphore.WaitAsync()

		Try
			Console.WriteLine($"Task {taskId} is converting large HTML to PDF.")
			Dim renderer = New ChromePdfRenderer()
			Dim pdf = Await renderer.RenderHtmlAsPdfAsync(htmlContent) ' Convert large HTML to PDF
			pdf.SaveAs(outputPath) ' Save the PDF file
			Console.WriteLine($"Task {taskId} has completed conversion.")
		Finally
			' Ensure the semaphore is released to allow other tasks to proceed.
			_semaphore.Release()
			Console.WriteLine($"Task {taskId} has released semaphore.")
		End Try
	End Function
End Class
$vbLabelText   $csharpLabel

在處理資源密集型任務，如將大型 HTML 文件轉換為 PDF 時，SemaphoreSlim 可以幫助平衡負載並優化資源使用。 設置 2 次同時進行的操作限制，避免因資源密集型的PDF生成任務而使系統不堪重負。 此方法有助於更均衡地分配工作負荷，提升整體應用效能和穩定性。

輸出影像：透過此方法生成的文件

C# Semaphoreslim（它如何為開發人員工作）：圖6

避免並發管理中的死結

如果信號量未正確釋放，可能會發生死結。 關於這點，需要記住的一個好習慣是使用 try-finally 區塊來確保即便發生異常也能釋放信號量，避免死結並使您的應用程式平穩運行。 避免死結的一些最佳做法包括始終在 finally 區塊中釋放信號量，並避免在非同步程式碼中使用阻塞調用如 Wait() 和 Result。

using IronPdf;
using System;
using System.Threading;
using System.Threading.Tasks;

class Program
{
    private static SemaphoreSlim _semaphore = new SemaphoreSlim(3);

    static async Task Main(string[] args)
    {
        var tasks = new Task[3];

        for (int i = 0; i < tasks.Length; i++)
        {
            string content = $"<h1>Document {i}</h1><p>Content for PDF {i}.</p>";
            string path = $"safe_output_{i}.pdf";

            // Start multiple tasks to demonstrate deadlock-free semaphore usage.
            tasks[i] = SafePdfTaskAsync(content, path, i);
        }

        await Task.WhenAll(tasks); // Wait for all tasks to finish.
    }

    // Method demonstrating best practices for using SemaphoreSlim to avoid deadlocks.
    public static async Task SafePdfTaskAsync(string content, string path, int taskId)
    {
        Console.WriteLine($"Task {taskId} is waiting to generate PDF...");

        // Wait to enter the semaphore.
        await _semaphore.WaitAsync();

        try
        {
            Console.WriteLine($"Task {taskId} is generating PDF.");
            var renderer = new ChromePdfRenderer();
            var pdf = await renderer.RenderHtmlAsPdfAsync(content); // Render HTML to PDF
            pdf.SaveAs(path); // Save the PDF
            Console.WriteLine($"Task {taskId} has completed PDF generation.");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Task {taskId} encountered an error: {ex.Message}");
        }
        finally
        {
            // Always release the semaphore, even if an error occurs.
            _semaphore.Release();
            Console.WriteLine($"Task {taskId} has released semaphore.");
        }
    }
}
using IronPdf;
using System;
using System.Threading;
using System.Threading.Tasks;

class Program
{
    private static SemaphoreSlim _semaphore = new SemaphoreSlim(3);

    static async Task Main(string[] args)
    {
        var tasks = new Task[3];

        for (int i = 0; i < tasks.Length; i++)
        {
            string content = $"<h1>Document {i}</h1><p>Content for PDF {i}.</p>";
            string path = $"safe_output_{i}.pdf";

            // Start multiple tasks to demonstrate deadlock-free semaphore usage.
            tasks[i] = SafePdfTaskAsync(content, path, i);
        }

        await Task.WhenAll(tasks); // Wait for all tasks to finish.
    }

    // Method demonstrating best practices for using SemaphoreSlim to avoid deadlocks.
    public static async Task SafePdfTaskAsync(string content, string path, int taskId)
    {
        Console.WriteLine($"Task {taskId} is waiting to generate PDF...");

        // Wait to enter the semaphore.
        await _semaphore.WaitAsync();

        try
        {
            Console.WriteLine($"Task {taskId} is generating PDF.");
            var renderer = new ChromePdfRenderer();
            var pdf = await renderer.RenderHtmlAsPdfAsync(content); // Render HTML to PDF
            pdf.SaveAs(path); // Save the PDF
            Console.WriteLine($"Task {taskId} has completed PDF generation.");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Task {taskId} encountered an error: {ex.Message}");
        }
        finally
        {
            // Always release the semaphore, even if an error occurs.
            _semaphore.Release();
            Console.WriteLine($"Task {taskId} has released semaphore.");
        }
    }
}
Imports IronPdf
Imports System
Imports System.Threading
Imports System.Threading.Tasks

Friend Class Program
	Private Shared _semaphore As New SemaphoreSlim(3)

	Shared Async Function Main(ByVal args() As String) As Task
		Dim tasks = New Task(2){}

		For i As Integer = 0 To tasks.Length - 1
			Dim content As String = $"<h1>Document {i}</h1><p>Content for PDF {i}.</p>"
			Dim path As String = $"safe_output_{i}.pdf"

			' Start multiple tasks to demonstrate deadlock-free semaphore usage.
			tasks(i) = SafePdfTaskAsync(content, path, i)
		Next i

		Await Task.WhenAll(tasks) ' Wait for all tasks to finish.
	End Function

	' Method demonstrating best practices for using SemaphoreSlim to avoid deadlocks.
	Public Shared Async Function SafePdfTaskAsync(ByVal content As String, ByVal path As String, ByVal taskId As Integer) As Task
		Console.WriteLine($"Task {taskId} is waiting to generate PDF...")

		' Wait to enter the semaphore.
		Await _semaphore.WaitAsync()

		Try
			Console.WriteLine($"Task {taskId} is generating PDF.")
			Dim renderer = New ChromePdfRenderer()
			Dim pdf = Await renderer.RenderHtmlAsPdfAsync(content) ' Render HTML to PDF
			pdf.SaveAs(path) ' Save the PDF
			Console.WriteLine($"Task {taskId} has completed PDF generation.")
		Catch ex As Exception
			Console.WriteLine($"Task {taskId} encountered an error: {ex.Message}")
		Finally
			' Always release the semaphore, even if an error occurs.
			_semaphore.Release()
			Console.WriteLine($"Task {taskId} has released semaphore.")
		End Try
	End Function
End Class
$vbLabelText   $csharpLabel

透過使用 try-catch-finally 區塊，我們確保即便拋出異常，也總會釋放 SemaphoreSlim 物件，從而避免死結。 透過日誌錯誤並正確地管理信號量釋放，我們可以使程式保持穩定並防止任何意外行為。

如下圖所示，透過嘗試載入不存在的 HTML 文件，我模擬了一個錯誤，即便產生此錯誤，程式還是會列印錯誤資訊告訴我出了什麼問題，然後使用 finally 區塊釋放信號量。

C# Semaphoreslim（它如何為開發人員工作）：圖7

使用 IronPDF 處理並發 PDF 的好處

高效且可靠的 PDF 處理

IronPDF 旨在高效地處理並發 PDF 處理任務，提供的性能和可靠性優於許多其他 PDF 程式庫。 其強大的架構使其能隨著應用程式需求的增長而擴展，這使其非常適合於需求大的環境。 與其他基於性能、易用性和穩健性標準的 PDF 程式庫相比，IronPDF 被證明是一個強有力的競爭對手。 為了說明這一點，我將 IronPDF 與 iText、PDFSharp、DinkToPdf 和 EvoPDF 等其他幾個受歡迎的 PDF 程式庫進行了比較：

1. 性能

IronPDF：

  • 渲染速度： IronPDF 因其快速高效的渲染能力而聞名，特別是在將 HTML 轉換為 PDF 時。 它使用基於 Chrome 的渲染，提供高度忠實於原始 HTML 內容的細節，包括 CSS 和 JavaScript 執行。
  • 資源管理： IronPDF 優化了處理大型和複雜 PDF 的記憶體使用，相比其他程式庫使用更少的記憶體，使其適合高容量應用程式。
  • 異步操作： 支持異步 PDF 生成，允許在需要響應性的 Web 應用中實現更好的性能。

iText：

  • 渲染速度： iText 對於以文字為主的 PDF 能提供良好性能，但在處理複雜佈局或圖像時可能明顯減慢。
  • 資源管理： 處理大文件或進行複雜操作時，iText 可能需要更多的記憶體，這在某些情況下可能導致性能瓶頸。

PDFSharp：

  • 渲染速度： 當處理複雜佈局或將 HTML 轉換為 PDF 時，相較於 IronPDF，PDFSharp 通常較慢，因為它缺少本地 HTML 渲染引擎。
  • 資源管理： 它在記憶體使用上不夠優化，可能在處理大型文件或包含眾多圖像的文件時遇到困難。

DinkToPdf：

  • 渲染速度： DinkToPdf 使用 wkhtmltopdf 引擎，對基本的 HTML 到 PDF 轉換有效，但對於更複雜或動態內容可能力有未逮。
  • 資源管理： 它通常需要大量的記憶體和處理能力，且缺乏針對高負載場景的原生異步操作支持。

EvoPDF：

  • 渲染速度： EvoPDF 也提供類似 IronPDF 的基於 Chrome 的渲染，提供良好的性能，尤其是在 HTML 到 PDF 的轉換方面。
  • 資源管理： 它優化良好，但在某些場景中可能仍需更多資源，因為其優化力度不如IronPDF。

2. 易用性

IronPDF：

  • API設計： IronPDF 提供了現代、直觀的 API，易於各種技能水平的開發者使用。 該程式庫設計上與 .NET 應用程式無縫協作，使其成為 C# 開發者的絕佳選擇。
  • 文件和支持： 詳盡的文件、大量的程式碼範例，以及優秀的客戶支持，使開始和快速解決問題變得容易。
  • 安裝和整合： 可透過 NuGet 輕鬆安裝，且可順利整合到現有的 .NET 項目中，所需配置最少。

iText：

  • API設計： iText 學習曲線陡峭，API 較為複雜，可能使初學者不堪重負。 其靈活性是以簡潔為代價的。
  • 文件和支持： 雖然文件完善，但擴展的配置選項會使尋找常見任務的簡單範例變得更加困難。
  • 安裝和整合： 可透過 NuGet 獲得，但需要更深入理解 API 才能有效整合。

PDFSharp：

  • API設計： PDFSharp 旨在為基本的 PDF 任務提供簡單性，但缺乏即開即用的高級功能，這可能限制其用於更複雜的場景。
  • 文件和支持： 提供基本文件，但其範圍不如 IronPDF，對於高級使用的詳細範例缺乏。
  • 安裝和整合： 透過 NuGet 可輕鬆安裝，但提供的 HTML 到 PDF 功能有限。

DinkToPdf：

  • API設計： DinkToPdf 的 API 相對簡單，但與 IronPDF 相比較不精緻。 它主要針對 HTML 到 PDF 的轉換，提供的直接 PDF 操作功能較少。
  • 文件和支持： 文件有限，社群支持較 IronPDF 等其他程式庫不夠強大，使故障排除更加困難。
  • 安裝和整合： 安裝可能更複雜，需要額外的依賴項，如 wkhtmltopdf，這可能使設置複雜化。

EvoPDF：

  • API設計： EvoPDF 提供了與 IronPDF 類似的簡單明了的 API，專注於 HTML 到 PDF 的轉換，並注重易用性。
  • 文件和支持： 文件詳細，配有良好的支持選項，但社群驅動的範例不及 IronPDF。
  • 安裝和整合： 可透過 NuGet 套件輕鬆整合到 .NET 專案中。

3. 穩健性

IronPDF：

  • 功能集： IronPDF 非常穩健，支持多樣的功能集，包括 HTML 到 PDF 的轉換、PDF 編輯、文字抽取、加密、註釋和電子簽名。
  • 錯誤處理： 提供全面的錯誤處理和異常管理，使其在生產環境中可靠運行。
  • 相容性： 完全相容於 .NET Core、.NET 5+ 和舊版 .NET Framework，使其在不同專案型別中具有通用性。

iText：

  • 功能集： iText 極為穩健，擁有全面的功能集，幾乎支持任何 PDF 任務，包括複雜操作和表單處理。
  • 錯誤處理： 良好的錯誤處理，但由於程式庫的複雜性，管理起來可能很複雜。
  • 相容性：

PDFSharp：

iText 適用於多種環境，包括 .NET Framework 和 .NET Core。 功能集： 提供基本的 PDF 建立和操作功能。 缺乏一些高級功能，如 HTML 到 PDF 的轉換和更複雜的文件編輯功能。 錯誤處理： 提供基本錯誤處理。 在複雜場景中，可靠性不如 IronPDF 這種較穩健的程式庫。

DinkToPdf：

  • 相容性： 相容於 .NET Framework 和 .NET Core，但高級功能有限。 * 功能集： 主要集中於 HTML 到 PDF。 缺乏一些高級功能，如 HTML 到 PDF 的轉換和更複雜的文件編輯功能。 在直接的 PDF 操作方面有所局限，缺少高級功能，如註釋和表單處理。
  • 相容性： 相容 .NET Core 和 .NET Framework，但需要外部依賴，可能引發相容性問題。

EvoPDF：

  • 功能集： 提供與 IronPDF 類似的強大功能集，包括高級 HTML 到 PDF 的轉換和一些文件操作能力。
  • 錯誤處理： 提供全面的錯誤處理，並在生產環境中表現可靠。
  • 相容性： 完全相容 .NET Core、.NET Framework 和更新的 .NET 版本，從而提供了多功能性和可靠性。

總結

  • 性能： IronPDF 和 EvoPDF 因其基於 Chrome 的渲染引擎而在性能上領先，而 iText 和 PDFSharp 在處理複雜文件時可能落後。
  • 易用性： IronPDF 憑藉其直觀的 API 和詳盡的文件脫穎而出，對各層次的開發者來說都很易用。 iText 提供的是權力，而非簡單性，DinkToPdf 和 PDFSharp 則較為簡單但功能較少。
  • 穩健性： IronPDF 和 iText 提供最強大的功能集，IronPDF 提供更簡單的整合和現代功能，如異步支持，iText 則涵蓋更多利基用途，但學習曲線更為陡峭。

對非同步程式設計的全面支持

IronPDF 與 非同步 程式設計模型無縫整合，補足了信號量控制機制，如 SemaphoreSlim。 這使得開發者可以建構響應性和友好性能的應用程式，而且所需努力最小。

IronPDF 亦提供詳盡的文件和支持資源，幫助開發人員理解和實施有效的錯誤處理做法。 這種全面支持在.NET專案中的故障排除和優化PDF操作方面非常珍貴。

IronPDF 提供：

  • 詳盡的文件： 遍及所有功能的詳細且使用者友好的文件。
  • 24/5 支持： 可取得工程師的積極支持。
  • 影片教程： 在 YouTube 上可以找到逐步的影片教程。
  • 社群論壇： 參與社群提供額外的支持。
  • PDF API 參考： 提供 API 參考，讓您能最大程度利用我們的工具。

欲了解更多資訊，請查看 IronPDF 的詳盡文件。

結論

在.NET應用程式中，使用SemaphoreSlim進行並發管理至關重要，特別是當處理如PDF處理這樣的資源密集型任務時。 通過將 SemaphoreSlim 與 IronPDF 結合，開發人員可以實現安全、高效和可靠的並發控制，確保其應用程式保持響應性和性能友好。

了解 IronPDF 如何簡化您的 PDF 處理工作流程。 透過其免費試用進行親自嘗試，試用從 $999 開始，如要將這個強大的工具持續整合到您的專案中。

C# Semaphoreslim（它如何為開發人員工作）：圖8

常見問題

SemaphoreSlim在併發管理中的角色是什麼？

SemaphoreSlim在併發管理中起著至關重要的作用，透過限制可以同時存取特定資源的執行緒數量來實現。這種控制有助於防止競爭條件並確保執行緒安全，尤其是在與IronPDF等程式庫整合進行PDF生成時。

如何將SemaphoreSlim與PDF程式庫整合以提升性能？

您可以將SemaphoreSlim與IronPDF整合來管理同時進行的PDF生成任務的數量。這樣做可以防止性能下降並確保執行緒同步，從而實現高效的PDF處理。

使用SemaphoreSlim和非同步編程有哪些優勢？

SemaphoreSlim支援非同步等待方法，使其非常適合用於非同步編程模型。這種相容性允許進行響應式應用程式開發，尤其是在使用IronPDF以多執行緒環境生成和操作PDF時。

SemaphoreSlim如何增強C#應用程式中的PDF生成？

SemaphoreSlim透過確保只能讓指定數量的執行緒同時存取PDF生成任務，來增強PDF生成。這種控制存取可防止系統過載，並優化IronPDF在C#應用程式中的性能。

多執行緒PDF生成的常見問題有哪些，如何避免？

常見問題包括競爭條件和死鎖。透過使用SemaphoreSlim與IronPDF，您可以限制同時執行緒的數量，從而避免競爭條件。此外，確保妥善釋放信號燈可以防止死鎖。

SemaphoreSlim能否提高併發PDF處理的可靠性？

是的，透過與IronPDF一起使用SemaphoreSlim，您可以控制同時處理PDF的執行緒數量，從而提高多執行緒環境中的可靠性和一致性。

與其他程式庫相比，IronPDF何以成為生成PDF的強大選擇？

IronPDF被認為是強大的，因為其快速的基於Chrome的渲染引擎、易於使用、豐富的文件，並具有與非同步編程模型的無縫整合，使其優於iTextSharp和EvoPDF等程式庫。

開發人員如何進一步了解SemaphoreSlim與IronPDF的實作？

開發人員可以探索IronPDF提供的全面文件，其中包括詳細的指南、API參考和教學。這些資訊結合SemaphoreSlim資源，可以幫助有效地將其一起實作。

Jacob Mellor，首席技術官 @ Team Iron
Jacob Mellor
  立即與工程團隊聊天
首席技術官

Jacob Mellor是Iron Software的首席技術官，一位在C# PDF技術上開創先河的遠見工程師。作為Iron Software核心程式碼庫的原開發者，他從創立以來就一直在塑造公司的產品架構，與首席執行官Cameron Rimington一起將公司轉變為服務於NASA、特斯拉和全球政府公司的50多名人員的公司。

Jacob擁有曼徹斯特大學的土木工程一等榮譽學士學位（BEng），於1998-2001年之間獲得。在1999年於倫敦創辦他的第一家軟體公司並於2005年建立了他的第一批.NET元組件後，他專注於解決Microsoft生態系統中的複雜問題。

他的旗艦IronPDF和Iron Suite .NET程式庫在全球獲得了超過3000萬次NuGet安裝依據，他的基礎程式碼基繼續支援著世界各地開發者使用的工具。擁有25年的商業經驗和41年的程式設計專業知識，他仍專注於推動企業級C#、Java和Python PDF技術的創新，同時指導下一代技術領導者。

相關文章

30天試用 → 完整產品。無限制。無需卡片。 開始免費試用

Iron 支援團隊

我們線上24小時，每週5天。
聊天
電子郵件
給我打電話