信息圖標
跳過到頁腳內容
  1. IronPDF
  2. IronPDF博客
  3. .NET幫助
  4. C# Volatile
.NET幫助

C# Volatile（對於開發者的運行原理）

Jacob Mellor, Team Iron 首席技術官
Jacob Mellor
更新:

C# 中的 volatile 關鍵字用來指示某個欄位可能被並發執行的執行緒更新。 已標示為 volatile 的欄位會提醒編譯器和執行時，並發執行緒或其他程式元件可能會在沒有警告的情況下變更欄位的值。 這可保證對該欄位的記憶體存取不會被編譯器優化掉，這可能會在 多執行緒應用程式中導致意想不到的行為。

IronPDF for .NET 是一個廣受歡迎的 C# 函式庫，用於建立和修改 PDF 文件，其名稱為 IronPDF - .NET PDF Library。 在使用 IronPDF 建立或操作 PDF 的多執行緒應用程式或程式時，了解如何正確使用 volatile 關鍵字至關重要。 這將有助於確保多個執行緒存取資料時，資料能正確同步且一致。

本教學將介紹使用 IronPDF 和 volatile 關鍵字建立可靠的多執行緒應用程式以產生或操作 PDF 的最佳方法。 我們將介紹 volatile 欄位的常見用途、如何正確宣告和使用 volatile 欄位，以及確保 IronPDF 驅動的應用程式為執行緒安全的建議做法。 現在讓我們開始吧

如何使用 C# Volatile

1.導入必要的程式庫。 2.宣告易變變數。 3.開始 PDF 生成任務。 4.在任務中設定易變變數。 5.檢查揮發性變數。 6.等待 PDF 生成。 7.處理 PDF 完成。

什麼是 C# Volatile？

宣告一個可以被多個執行緒同時修改的欄位，可以使用 volatile 關鍵字。 當一個欄位被指定為 volatile 時，編譯器和執行時會提醒其他程式元件（包括並發執行緒）可能會在沒有警告的情況下修改其值。因此，對 volatile 欄位的讀取和寫入總是先直接從主記憶體進行。

volatile 關鍵字透過強制執行記憶體屏障來解決與重新排序記憶體操作相關的問題。 記憶體障礙可確保記憶體作業不會在易失性存取時重新排序，避免在多執行緒情況下發生意想不到的行為。

透過在易失性讀取操作之前和之後或在易失性寫入操作期間隱式地使用記憶體屏障，volatile 保證了記憶體操作的正確順序，增強了並發環境中的執行緒安全性和資料一致性，而不是在使用任何非易失性對象時可能出現的問題。

易變關鍵字的目的

C# 中的 volatile 關鍵字主要用於處理多個執行緒不正確地同步存取和修改共享資料的記憶體位置的情況。 在多執行緒設定中，編譯器可能會優化記憶體存取的方式，如果不存在 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();
    }
}
Imports System
Imports System.Threading

Friend Class SharedStateExample
'INSTANT VB TODO TASK: There is no VB equivalent to 'volatile':
'ORIGINAL LINE: private volatile bool _isRunning = true;
	Private _isRunning As Boolean = True

	Public Sub Run()
		Dim thread1 As New Thread(AddressOf ChangeState)
		Dim thread2 As New Thread(AddressOf ReadState)
		thread1.Start()
		thread2.Start()
	End Sub

	Private Sub ChangeState()
		Do While _isRunning
			Console.WriteLine("Changing state...")
			Thread.Sleep(1000)
			_isRunning = False
		Loop
	End Sub

	Private Sub ReadState()
		Do While _isRunning
			Console.WriteLine("Reading state...")
			Thread.Sleep(500)
		Loop
		Console.WriteLine("State is no longer running.")
	End Sub
End Class

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim example As New SharedStateExample()
		example.Run()
	End Sub
End Class
$vbLabelText   $csharpLabel

本範例中的 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));
    }
}
Imports System

Friend Class Singleton
'INSTANT VB TODO TASK: There is no VB equivalent to 'volatile':
'ORIGINAL LINE: private static volatile Singleton _instance;
	Private Shared _instance As Singleton
	Private Shared ReadOnly _lock As New Object()

	Private Sub New()
	End Sub

	Public Shared Function GetInstance() As Singleton
		If _instance Is Nothing Then
			SyncLock _lock
				If _instance Is Nothing Then
					_instance = New Singleton()
				End If
			End SyncLock
		End If
		Return _instance
	End Function
End Class

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim instance1 As Singleton = Singleton.GetInstance()
		Dim instance2 As Singleton = Singleton.GetInstance()
		Console.WriteLine("Are instances equal? " & (instance1 Is instance2))
	End Sub
End Class
$vbLabelText   $csharpLabel

在這個範例中，我們使用雙重檢查的鎖定機制來建構一個執行緒安全的 Singleton 設計。 為了確保多個執行緒之間所做的修改是最新的且可見的，_instance 欄位被指定為 volatile 類型。這避免了單一執行緒發現單例實例僅部分初始化的情況。 即使在多執行緒的情況下，雙重檢查的鎖定機制也能保證只產生一個 Singleton 的實例。

什麼是 IronPDF？

C# 函式庫 IronPDF - PDF Generation and Editing 可讓程式設計師在 .NET 應用程式內建立、修改及渲染 PDF 文件。 其豐富的功能集使處理 PDF 檔案變得簡單。 已存在的 PDF 文件可以編輯、分割和合併。 PDF 文件可以 HTML、圖片和其他形式建立。 PDF 上可以註明文字、照片和其他資料。

IronPDF 的特點

文字與圖片註解

使用 IronPDF，您可以用文字、圖片和其他資料對 PDF 文件進行程式化註釋。 您可以使用此工具為 PDF 檔案加上簽名、圖章和註解。

PDF安全性

IronPDF 允許您指定不同的權限，包括列印、複製和編輯文件，並且可以使用密碼加密 PDF 文件。 這有助於控制誰可以存取 PDF 檔案以及保護機密資訊。

填寫互動式 PDF 表單

使用 IronPDF，可透過程式填寫互動式 PDF 表單。 此功能有助於根據使用者輸入建立個人化文件，以及自動化表單提交。

PDF 壓縮與最佳化

IronPDF 提供 PDF 檔案最佳化與壓縮的選擇，可在不犧牲品質的情況下，將檔案大小減至最小。 因此，PDF 文件所需的儲存空間更少，運作效率更高。

跨平台相容性

IronPDF for .NET 可在 Windows、Linux 和 macOS 等多種作業系統上與 .NET 程式完美配合。 知名的 .NET Framework，如 ASP.NET、.NET Core 和 Xamarin 都與之整合。

建立新的 Visual Studio 專案

在 Visual Studio 中建立控制台專案是一個簡單直接的過程。 若要啟動控制台應用程式，請在 Visual Studio 環境中遵循以下簡單步驟：

使用 Visual Studio 之前，請確定您的電腦已安裝 Visual Studio。

開始新專案

選擇"檔案"，然後選擇"新增"，最後選擇"專案"。

C# Volatile (How It Works For Developers)：圖 1

在"建立新專案"方塊中，從左側清單中選擇您偏好的程式語言 (例如 C#)。

以下專案範本參考清單中有 "Console App" 或 "Console App (.NET Core)" 範本可供選擇。

在"名稱"欄位中提供專案名稱。

C# Volatile (How It Works For Developers)：圖 2

選擇專案的保存位置。

按一下"建立"即可啟動 Console 應用程式專案。

C# Volatile (How It Works For Developers)：圖 3

安裝 IronPDF。

工具"下的 Visual Studio Tools 功能表項目包含 Visual Command-Line 介面。 選擇 NuGet Package Manager。 在套件管理終端標籤上，您必須鍵入下列指令。

Install-Package IronPdf

另外，您也可以使用套件管理員。 使用 NuGet Package Manager 選項可將套件直接安裝到解決方案中。 使用 NuGet Manager 網站的搜尋方塊來尋找套件。 接下來的範例截圖顯示了在套件管理員中搜尋"IronPDF"有多容易：

C# Volatile (How It Works For Developers)：圖 4 - 從 NuGet 套件管理員安裝 IronPDF

相關的搜尋結果顯示於上圖。 請進行以下變更，以便軟體更容易安裝在您的機器上。

下載並安裝套件後，我們就可以在進行中的專案中使用了。

使用 C# Volatile 和 IronPDF 確保 PDF 生成過程中的執行緒安全。

現在讓我們在 C# 程式中同時使用 IronPDF 和 volatile 關鍵字。 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(htmlContent);
        // 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(htmlContent);
        // 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();
    }
}
Imports IronPdf
Imports System
Imports System.Threading

Friend Class PdfGenerator
'INSTANT VB TODO TASK: There is no VB equivalent to 'volatile':
'ORIGINAL LINE: private volatile bool _isRunning = true;
	Private _isRunning As Boolean = True
	Private ReadOnly _lock As New Object()

	Public Sub GeneratePdf(ByVal filePath As String)
		Dim thread As New Thread(Sub()
			Do While _isRunning
				' Generate PDF document
				GenerateDocument(filePath)
				' Sleep for some time
				System.Threading.Thread.Sleep(5000)
			Loop
		End Sub)
		thread.Start()
	End Sub

	Public Sub StopPdfGeneration()
		SyncLock _lock
			_isRunning = False
		End SyncLock
	End Sub

	Private Sub GenerateDocument(ByVal filePath As String)
		' Load HTML content
		Dim htmlContent As String = "<html><body><h1>Hello, IronPDF!</h1></body></html>"
		' Convert HTML to PDF
		Dim renderer = New ChromePdfRenderer()
		Dim pdfDocument = renderer.RenderHtmlAsPdf(htmlContent)
		' Save PDF to file
		pdfDocument.SaveAs(filePath)
		' Output status
		Console.WriteLine($"PDF generated and saved to {filePath}")
	End Sub
End Class

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim pdfGenerator As 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()
	End Sub
End Class
$vbLabelText   $csharpLabel

volatile bool isRunning:我們將 _isRunning 欄位指定為 volatile 變數，表示多個執行緒可能會對其進行更改。 PDF 文件的生成由本領域管理。 如果 _isRunning 為真，則繼續建立 PDF； 否則退出。

GeneratePdf(string filePath):此函數啟動一個新執行緒，按計畫建立 PDF 文件。 我們在主執行緒中持續檢查 _isRunning 標誌。 如果是這樣，我們會使用 IronPDF 建立 PDF 文件，並將其儲存到指定的檔案目錄。

StopPdfGeneration():此函數可以停止建立 PDF 檔案。 為了在更改 _isRunning 標誌時保持執行緒安全，它鎖定了一個名為 _lock 的私有物件。

GenerateDocument(string filePath):此函數包含使用 IronPDF 建立 PDF 文件所需的程式碼。 建立 ChromePdfRenderer 的實例，載入 HTML 內容，將其轉換為 PDF 文檔，並將 PDF 儲存到指定的文件目錄。

Main(string[] args):實例化 PdfGenerator 類，開始產生 PDF，並在 Main 方法中提示使用者按任意鍵停止產生 PDF。

C# Volatile (How It Works For Developers)：圖 5

本範例展示如何使用 IronPDF 和 volatile 關鍵字在多執行緒環境中可靠地產生 PDF 文件。 我們利用 volatile 有效地控制 PDF 建立過程，以確保對 _isRunning 標誌的更改在執行緒中立即可見。 我們還使用鎖來存取和修改 _isRunning 標誌，同時保持工作執行緒安全。

C# Volatile (How It Works For Developers)：圖 6

結論

總而言之，將 volatile 關鍵字引入 IronPDF 提供了一種強有力的方法來確保在多執行緒 C# 程式中建立 PDF 時的執行緒安全性。 我們透過指定共用控制標誌為易變，確保能及時察覺並正確同步各執行緒間的變更，為 PDF 製作過程提供有效的控制。

透過確保控制標誌的變更立即廣播到所有執行緒，volatile 可以避免衝突，並促進 PDF 建立過程中涉及的進程的高效協調。

應用程式可有效地同時管理多個 PDF 產生程序，而不會有資料損毀或競賽情況的風險，這都要歸功於此方法，它改善了 PDF 在並發情況下產生的可擴展性和可靠性。

最後，您可以透過包含 IronPDF 和 輕鬆探索 Iron Software 庫的全部潛力，有效率地處理條碼、建立 PDF、進行 OCR 以及與 Excel 連線。 Iron Software 不費吹灰之力地將其多功能套件的效能、相容性和易用性結合在一起，提供增強的應用程式功能和更有效的開發。

如果有針對專案特殊需求的明確授權選項，開發人員就可以放心選擇最佳模式。 這些優點可讓開發人員有效且透明地解決各種挑戰。

常見問題解答

怎樣在 C# 中將 HTML 轉換為 PDF？

您可以使用 IronPDF 的 RenderHtmlAsPdf 方法將 HTML 字符串轉換為 PDF。您還可以使用 RenderHtmlFileAsPdf 將 HTML 文件轉換為 PDF。

C#中volatile关键字的目的是什么？

C#中的volatile关键字用于指出一個字段可能会被同時执行的线程更新，從而确保內存访問不会被编译器优化掉，以防止在多线程應用中出現意外行為。

volatile关键字如何改善C#中的數据一致性？

通過将一個字段標记為volatile，你強制內存屏障以确保內存操作不会在volatile访問之间重新排序。这保證了字段的更改對所有线程立即可见，從而提高并發环境中的數据一致性。

C#中volatile关键字的一些常见用途是什么？

volatile关键字的常见用途包括被多個线程访問而没有適当同步的字段，确保更改對所有线程立即可见，并防止缓存問题。

如何在C#中确保生成PDF時的线程安全？

使用volatile关键字来管理多线程應用中的共享状态，并依赖IronPDF的线程安全方法来處理PDF生成，确保數据一致性和同步得以维持。

IronPDF在.NET中提供了哪些處理PDF文檔的功能？

IronPDF提供文本和图像批注、PDF安全性、交互式表单填写、PDF压缩和优化，以及.NET應用的跨平台兼容性等功能。

如何在Visual Studio項目中安装PDF處理庫？

你可以使用NuGet包管理器在Visual Studio項目中安装IronPDF。在包管理器控制台運行Install-Package IronPDF或在NuGet包管理器中搜索IronPDF并直接安装它。

內存屏障如何与volatile关键字一起工作？

volatile中的內存屏障防止跨越volatile访問的內存操作重新排序，确保所有线程看到操作的正确顺序，從而维护數据一致性和线程安全。

C#中的线程安全单例是什么，以及volatile如何帮助？

可以使用volatile创建线程安全的单例，通過将實例变量標记為volatile，并使用双重检查锁定机制来确保即使在多线程环境中也仅创建一個實例。

為什么直接內存访問在多线程應用中重要？

直接內存访問确保從主內存读取和写入字段的最新值，防止多线程應用中由于缓存导致的陈旧數据問题。

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

Jacob Mellor是Iron Software的首席技術官，也是開創C# PDF技術的前瞻性工程師。作為Iron Software核心代碼庫的原始開發者，他自公司成立以來就塑造了公司的產品架構，並與CEO Cameron Rimington將公司轉型為服務NASA、Tesla以及全球政府機構的50多人公司。

Jacob擁有曼徹斯特大學土木工程一級榮譽學士學位（1998年–2001年）。他於1999年在倫敦開立首家軟體公司，並於2005年建立了他的第一個.NET組件，專注於解決Microsoft生態系統中的複雜問題。

他的旗艦作品IronPDF和Iron Suite .NET程式庫全球已獲得超過3000萬次NuGet安裝，他的基礎代碼不斷在全球各地驅動開發者工具。擁有25年以上的商業經驗和41年的編碼專業知識，Jacob仍然專注於推動企業級C#、Java和Python PDF技術的創新，同時指導下一代技術領導者。

相關文章

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

鋼鐵支援團隊

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