1. IronPDF
  2. IronPDF 部落格
  3. .NET 幫助
  4. C# Volatile
.NET 幫助

C# Volatile (對開發者的運作方式)

發佈 2024年8月13日
分享:

介紹

在 C# 中，volatile 關鍵字用於表示一個字段可能會被同時執行的線程更新。被標記為 volatile 的字段 易變 警告編譯器和運行時，並發線程或其他程式元件可能會在沒有警告的情況下更改欄位的值。這保證了對該欄位的記憶體存取不會被編譯器優化掉，這可能會導致不可預期的行為。 多執行緒應用程式一個受歡迎的 C# 用於創建和修改 PDF 文檔的庫叫做 IronPDF. 了解如何適當地使用 volatile 關鍵字在處理多線程應用程序或使用 IronPDF 進行 PDF 創建或操作的程式時至關重要。這將有助於確保數據在多個線程訪問時能夠正確同步和一致。

本教程將涵蓋最佳使用 IronPDF 和 volatile 關鍵字的方法，以創建可靠的多線程應用程序，生成或操作 PDF。我們將討論 volatile 字段的常見用法、如何正確地聲明和使用 volatile 字段，以及確保您的 IronPDF 驅動應用程序線程安全的推薦做法。現在讓我們開始吧。!

如何使用 C# Volatile

  1. 導入必要的庫。

  2. 聲明 Volatile 變量。

  3. 開始 PDF 生成任務。

  4. 在任務中設置 Volatile 變量。

  5. 檢查 Volatile 變量。

  6. 等待 PDF 生成。

  7. 處理 PDF 完成。

C# 中的 volatile 是什麼？

宣告一個可能被多個同時執行的執行緒更改的欄位，是透過使用 volatile 關鍵字來完成的。當某個欄位被指定為 volatile 時，編譯器和執行期會被通知其他程式組件（包括並發執行的執行緒）可能會在沒有警告的情況下修改其值。因此，對 volatile 欄位的讀取和寫入操作總是直接從相同的記憶體進行。

volatile 關鍵字通過強制記憶體屏障來解決重新排序記憶體操作的相關問題。記憶體屏障確保記憶體操作不會跨越 volatile 訪問重新排序，防止在多執行緒場景中出現意外行為。

通過在 volatile 讀取前後或在 volatile 寫入操作期間隱式地使用記憶體屏障，volatile 保證了記憶體操作的正確排序，增強了並發環境中的執行緒安全性和數據一致性，這與使用非 volatile 物件時可能出現的問題相反。

Volatile 關鍵字的用途

在 C# 中，volatile 關鍵字主要用來處理多個執行緒不正確同步訪問和修改共享數據的內存位置的情況。在多執行緒環境中，如果沒有使用 volatile 修飾符，編譯器可能會以某種方式優化內存訪問，這可能導致不可預測的行為。

開發人員可以通過將字段指定為 volatile 來向編譯器表明字段的值可能會異步更改，並且數據完整性需要直接內存訪問。

易失性关键字的行为

編譯器和運行時系統確保對標記為易失性的字段的每次讀寫內存操作都不使用任何可能的緩存方法。這意味著，即使執行緒將其緩存，易失性字段的值在後續訪問時將始終從主存儲器中獲取，而不是依賴於已經被緩存的相同值。同樣，因為對易失性字段的寫操作會立即傳播到內存，所以一個執行緒所做的修改對訪問相同字段的所有其他執行緒都是可見的。

使用 Volatile 來共享狀態

讓我們使用一些代碼範例來演示如何使用 volatile 關鍵字。

using System;
using System.Threading;
class SharedStateExample
{
    private volatile bool _isRunning = true;
    public void Run()
    {
        Thread thread1 = new Thread(ChangeState);
        Thread thread2 = new Thread(ReadState);
        thread1.Start();
        thread2.Start();
    }
    private void ChangeState()
    {
        while (_isRunning)
        {
            Console.WriteLine("Changing state...");
            Thread.Sleep(1000);
            _isRunning = false;
        }
    }
    private void ReadState()
    {
        while (_isRunning)
        {
            Console.WriteLine("Reading state...");
            Thread.Sleep(500);
        }
        Console.WriteLine("State is no longer running.");
    }
}
class Program
{
    static void Main(string[] args)
    {
        SharedStateExample example = new SharedStateExample();
        example.Run();
    }
}
using System;
using System.Threading;
class SharedStateExample
{
    private volatile bool _isRunning = true;
    public void Run()
    {
        Thread thread1 = new Thread(ChangeState);
        Thread thread2 = new Thread(ReadState);
        thread1.Start();
        thread2.Start();
    }
    private void ChangeState()
    {
        while (_isRunning)
        {
            Console.WriteLine("Changing state...");
            Thread.Sleep(1000);
            _isRunning = false;
        }
    }
    private void ReadState()
    {
        while (_isRunning)
        {
            Console.WriteLine("Reading state...");
            Thread.Sleep(500);
        }
        Console.WriteLine("State is no longer running.");
    }
}
class Program
{
    static void Main(string[] args)
    {
        SharedStateExample example = new SharedStateExample();
        example.Run();
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

在這個範例中，SharedStateExample 類別有一個標記為易失物件的 isRunning 欄位。建立了一個 ChangeState 方法來改變狀態，並建立一個 ReadState 方法以實現易失讀取操作狀態。

當 ReadState 方法不斷檢查 isRunning 的值時，ChangeState 方法延遲後將 isRunning 設置為 false。由於 isRunning 的易失特性，一個執行緒所做的改變，會立即顯示於另一執行緒。

使用 Volatile 的雙重檢查鎖定

using System;
class Singleton
{
    private static volatile Singleton _instance;
    private static readonly object _lock = new object();
    private Singleton() { }
    public static Singleton GetInstance()
    {
        if (_instance == null)
        {
            lock (_lock)
            {
                if (_instance == null)
                {
                    _instance = new Singleton();
                }
            }
        }
        return _instance;
    }
}
class Program
{
    static void Main(string[] args)
    {
        Singleton instance1 = Singleton.GetInstance();
        Singleton instance2 = Singleton.GetInstance();
        Console.WriteLine("Are instances equal? " + (instance1 == instance2));
    }
}
using System;
class Singleton
{
    private static volatile Singleton _instance;
    private static readonly object _lock = new object();
    private Singleton() { }
    public static Singleton GetInstance()
    {
        if (_instance == null)
        {
            lock (_lock)
            {
                if (_instance == null)
                {
                    _instance = new Singleton();
                }
            }
        }
        return _instance;
    }
}
class Program
{
    static void Main(string[] args)
    {
        Singleton instance1 = Singleton.GetInstance();
        Singleton instance2 = Singleton.GetInstance();
        Console.WriteLine("Are instances equal? " + (instance1 == instance2));
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

在這個例子中，我們使用雙重檢查鎖機制來構建一個線程安全的單例設計。為了保證多個線程之間所做的修改是即時可見的，_instance 字段被指定為 volatile。這避免了單個線程注意到一個只初始化了一半的單例實例的情況。即使在多線程上下文中，雙重檢查鎖機制也保證僅生成單例的唯一實例。

什麼是 IronPDF？

C# 函式庫 IronPDF 允許程式設計師在 .NET 應用程式中建立、修改和呈現 PDF 文件。其豐富的功能集使得處理 PDF 文件變得簡單。已存在的 PDF 文件可以被編輯、拆分和合併。PDF 文件可以以 HTML、圖像和其他形式建立。PDF 可以添加文字、照片和其他資料註解。

IronPDF 的功能

文字與圖像註釋

使用IronPDF，您可以以編程方式在PDF文件中添加文字、圖像和其他數據的註釋。您可以使用此工具在PDF文件上添加簽名、印章和評論。

PDF 安全性

IronPDF 允許您指定不同的權限，包括打印、複製和編輯文件，並且可以使用密碼對 PDF 進行讀取或寫入加密。這有助於控制誰能訪問 PDF 文件並保護機密信息。

填寫互動式 PDF 表單

使用 IronPDF，可以通過程式設計方式填寫互動式 PDF 表單。此功能對於根據使用者輸入生成個性化文件和自動化表單提交非常有用。

PDF 壓縮和優化

IronPDF 提供了 PDF 文件優化和壓縮的選項，可在不犧牲品質的情況下最小化大小。因此，PDF 文件需要更少的存儲空間且運行更有效率。

跨平台相容性

IronPDF 被設計為能夠在各種操作系統上與 .NET 程序完美運作，包括 Windows、Linux 和 macOS。知名的 .NET 框架如 ASP.NET、NET Core 和 Xamarin 都與其整合。

建立新的 Visual Studio 專案

在 Visual Studio 中建立控制台專案是簡單的過程。要開始一個控制台應用程式，請在 Visual Studio 環境中按以下簡單步驟操作：

在使用 Visual Studio 之前，請確保它已安裝在您的電腦上。

開始一個新專案

選擇檔案，然後選擇新建，最後選擇專案。

C# 易變性（開發人員如何使用）：圖 1

在「建立新專案」框中，選擇您偏好的程式語言 (例如，C#) 從左邊的列表中。

以下專案模板參考列表包含「控制台應用程式」或「控制台應用程式」 (.NET Core)`模板供選擇。

請在 "名稱" 欄位中提供您的項目名稱。

C# 波動 (對開發者的運作方式): 圖2

選擇專案將被保存的位置。

點擊「建立」將開始控制台應用程式專案。

C# Volatile（對開發者的工作原理）：圖 3

安裝 IronPDF

在 Visual Studio 的工具選單項目中，有一個 Visual Command-Line 介面。選擇 NuGet 套件管理員。在套件管理終端選項卡上，你必須輸入以下命令。

Install-Package IronPdf
Install-Package IronPdf
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Install-Package IronPdf
VB   C#

或者，您可以使用套件管理器。使用 NuGet 套件管理器選項，可以將套件直接安裝到方案中。使用 NuGet 網站的搜索框來定位套件。以下的範例截圖顯示如何在套件管理器中簡單搜索 "IronPDF":

C# Volatile（開發人員工作原理）：圖4—從NuGet套件管理器安裝IronPDF

在上方圖片中顯示了相關的搜索結果。請進行以下更改，以便在您的機器上更輕鬆地安裝軟體。

下載並安裝軟體包後，我們現在可以在進行中的項目中使用它。

使用 C# 的 Volatile 和 IronPDF 確保 PDF 生成的線程安全性

現在讓我們將 IronPDF 和 volatile 關鍵字一起用於 C# 程式中。IronPDF 是一個受歡迎的 C# 庫， 用於創建和修改 PDF 文件。在使用 IronPDF 進行 PDF 創建或處理的多線程應用程序中，必須保持線程安全。

以下是一個示例，展示如何在多線程環境中利用 IronPDF 的 volatile 關鍵字來創建 PDF 文件。

using IronPdf;
using System;
using System.Threading;
class PdfGenerator
{
    private volatile bool _isRunning = true;
    private readonly object _lock = new object();
    public void GeneratePdf(string filePath)
    {
        Thread thread = new Thread(() =>
        {
            while (_isRunning)
            {
                // Generate PDF document
                GenerateDocument(filePath);
                // Sleep for some time
                Thread.Sleep(5000);
            }
        });
        thread.Start();
    }
    public void StopPdfGeneration()
    {
        lock (_lock)
        {
            _isRunning = false;
        }
    }
    private void GenerateDocument(string filePath)
    {
        // Load HTML content
        string htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";
        // Convert HTML to PDF
        var renderer = new ChromePdfRenderer();
        var pdfDocument = renderer.RenderHtmlAsPdf(content);
        // Save PDF to file
        pdfDocument.SaveAs(filePath);
        // Output status
        Console.WriteLine($"PDF generated and saved to {filePath}");
    }
}
class Program
{
    static void Main(string[] args)
    {
        PdfGenerator pdfGenerator = new PdfGenerator();
        // Start PDF generation
        pdfGenerator.GeneratePdf("output.pdf");
        // Wait for user input to stop PDF generation
        Console.WriteLine("Press any key to stop PDF generation...");
        Console.ReadKey();
        // Stop PDF generation
        pdfGenerator.StopPdfGeneration();
    }
}
using IronPdf;
using System;
using System.Threading;
class PdfGenerator
{
    private volatile bool _isRunning = true;
    private readonly object _lock = new object();
    public void GeneratePdf(string filePath)
    {
        Thread thread = new Thread(() =>
        {
            while (_isRunning)
            {
                // Generate PDF document
                GenerateDocument(filePath);
                // Sleep for some time
                Thread.Sleep(5000);
            }
        });
        thread.Start();
    }
    public void StopPdfGeneration()
    {
        lock (_lock)
        {
            _isRunning = false;
        }
    }
    private void GenerateDocument(string filePath)
    {
        // Load HTML content
        string htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";
        // Convert HTML to PDF
        var renderer = new ChromePdfRenderer();
        var pdfDocument = renderer.RenderHtmlAsPdf(content);
        // Save PDF to file
        pdfDocument.SaveAs(filePath);
        // Output status
        Console.WriteLine($"PDF generated and saved to {filePath}");
    }
}
class Program
{
    static void Main(string[] args)
    {
        PdfGenerator pdfGenerator = new PdfGenerator();
        // Start PDF generation
        pdfGenerator.GeneratePdf("output.pdf");
        // Wait for user input to stop PDF generation
        Console.WriteLine("Press any key to stop PDF generation...");
        Console.ReadKey();
        // Stop PDF generation
        pdfGenerator.StopPdfGeneration();
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

volatile bool isRunning：我們將 isRunning 欄位指定為 volatile 變量，以表示有多個線程可能對其進行更改。PDF 文件的生成由此欄位管理。如果 isRunning 為 true，則繼續創建 PDF；否則就停止。

GeneratePdf(字串 檔案路徑)**：這個功能會啟動一個新線程以定期生成 PDF 文件。我們會在主線程中持續檢查 isRunning 標誌。如果是，我們會使用 IronPDF 來創建 PDF 文檔。 PDF文檔 並將其保存到指定的文件目錄。

StopPdfGeneration()**: 此功能使暫停 PDF 創建成為可能。為了在更改 isRunning 標誌時保持執行緒安全性，它鎖定了一個名為 lock 的私有物件。

GenerateDocument(字串 檔案路徑)此函數包含使用 IronPDF 創建 PDF 文件所需的代碼。創建了一個 HtmlToPdf 的實例，載入 HTML 信息，將其轉換為 PDF 文件，並將 PDF 保存到指定的文件目錄。(字串[] 參數)： PdfGenerator 類別被實例化，開始生成PDF，並在 Main 方法中提示用戶通過按任意鍵來停止生成PDF。

C# Volatile（對開發者的運行方式）：圖5

這個範例展示了如何在多執行緒環境中使用 IronPDF 和 volatile 關鍵字可靠地生成 PDF 文件。我們通過使用 volatile 來確保對 isRunning 標誌的更改在各執行緒之間即時可見，從而有效地控制 PDF 創建過程。我們還使用鎖來訪問和修改 isRunning 標誌，同時保證工作執行緒的安全。

C# Volatile（開發人員如何使用）：圖 6

結論

總而言之，在 IronPDF 引入 volatile 關鍵字提供了一種保證多執行緒 C# 程式中生成 PDF 時線程安全的有效方法。我們通過將共享控制標誌指定為 volatile，確保各個線程及時認識到並同步變更，有效控制 PDF 生成過程。

通過確保控制標誌的變更能夠立即向所有線程廣播，使用 volatile 可以避免衝突並促進 PDF 創建過程中各個進程的高效協調。

由於這種方法提高了在並發環境中生成 PDF 的可擴展性和可靠性，應用程序可以有效地同時管理多個 PDF 生成過程，而不會有數據損壞或競態影響的風險。

最後，通過包含 IronPDF，您可以有效地處理條碼、創建 PDF、進行 OCR 並與 Excel 連接。 IronSoftware 輕鬆結合Iron Software多功能套件的性能、兼容性和易用性，提供增強的應用能力和更有效的開發。

如果有針對特定項目需求量身訂做的明確許可選項，開發人員可以自信地選擇最佳模型。這些優勢使開發人員能夠有效且透明地應對各種挑戰。

< 上一頁
C# TryParse（開發者如何使用）
下一個 >
C# Task.Run (開發人員如何使用)
從NuGet 免費用於開發

安裝與 NuGet nuget.org/packages/IronPdf

PM > Install-Package IronPdf

報告問題

準備開始了嗎？ 版本: 2024.10 剛剛發布

免費 NuGet 下載 總下載次數： 10,993,239 查看許可證 >

免費獲取

30天試用序號 立即。

15天試用金鑰 立即。

bullet_checked不需要信用卡或帳戶註冊
試用表格已提交
成功。

您的試用金鑰應該在郵件中。
如果不是，請聯繫
support@ironsoftware.com

bullet_test在生产环境中测试
無浮水印
子彈日曆30天完整
功能性產品
bullet_support24/5 技術支援
試用期間支援

感謝您！

您的授權密鑰已發送到提供的電子郵件地址。聯絡我們

24小時升級優惠：

Save 50% 在一
專業 升級

去 專業 涵蓋10位開發人員
和無限專案。

小時

:

分鐘

:

秒钟

升級到專業版

升級

專業

$600 美元

$299 美元

  • 10 位開發人員
  • 10個地點
  • 10個專案
今天 唯一

5 個 .NET 產品只需 2 個價格

IronPDF IronOCR IronXL IronBarcode IronWebscraper

總套件價值：

$7,192 美元

升級價格

今天
唯一

$499 美元

24小時後

$1,098 美元