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

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

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

C#中的volatile關鍵字用於表示一個欄位可能會被同時執行的執行緒更新。 被標註為volatile的欄位會提醒編譯器和運行時，並發現協同執行緒和其他程式元件可能無預警地改變該欄位的值。 這保證了對該欄位的記憶體存取不會被編譯器優化掉，這可能會導致[多執行緒應用程式](https://en.wikipedia.org/wiki/Multithreading_(computer_architecture)中出現意外行為。

一個受歡迎的C#程式庫，用於建立和修改PDF文件，叫做IronPDF - .NET PDF Library。 在使用IronPDF進行PDF建立或操作等多執行緒應用程式時，正確使用volatile關鍵字至關重要。 這將有助於確保當多個執行緒存取資料時，資料得以適當同步和一致。

本教程將探討如何使用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的欄位的每次讀寫記憶體操作都應避免使用可能的快取方法。 這表明，不管執行緒是否快取了值，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類擁有一個被標註為volatile物件的_isRunning欄位。 一個ChangeState方法用於改變狀態，而ReadState方法則建立了一個volatile讀操作。

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

在此範例中，我們使用雙重檢查鎖機制構建了一個執行緒安全的單例設計。 為了保證在多執行緒間的修改是最新且可見的，_instance欄位被指定為volatile。這樣就避免了只有單一執行緒能夠注意到半初始化的Singleton實例的情形。 即便是在多執行緒環境中，雙重檢查鎖機制也能確保只產生一個Singleton實例。

IronPDF是什麼？

C#程式庫IronPDF - PDF生成與編輯允許程式員在.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在內的多種作業系統。 與ASP.NET、.NET Core和Xamarin等知名的.NET框架相整合。

建立一個新的Visual Studio專案

在Visual Studio中建立一個主控台專案是個直接的過程。 在Visual Studio環境中，請按照下面這些簡單步驟來啟動一個主控台應用程式：

在使用Visual Studio之前，確保其已經安裝於您的電腦。

開始一個新專案

選擇文件，然後新建，最後專案。

C# Volatile (How It Works For Developers): Figure 1

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

緊接著的專案範本參考清單提供了"Console App" 或 "Console App (.NET Core)" 範本可供選擇。

在"名稱"欄位中為您的專案提供一個名稱。

C# Volatile (How It Works For Developers): Figure 2

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

點擊 "建立" 將啟動主控台應用專案。

C# Volatile (How It Works For Developers): Figure 3

安裝IronPDF

在Visual Studio的Tools選單項目下的工具中包含了Visual Command-Line介面。 選擇NuGet Package Manager。 在套件管理終端標籤上，您必須鍵入以下命令。

Install-Package IronPdf

或者，您可以使用Package Manager。 可以使用NuGet套件管理器選項直接將套件安裝到解決方案中。 使用NuGet Manager網站上的搜尋框來尋找包。 隨後的範例截圖顯示了在包管理器中搜尋"IronPDF"的便利程度：

C# Volatile (How It Works For Developers): Figure 4 - Installing IronPDF from the NuGet package manager

上述圖片顯示了相關搜尋結果。 請對以下更改，以便於在您的機器上更容易安裝該軟體。

下載並安裝插件後，我們現在可以在正在進行的專案中使用它。

透過C# Volatile和IronPDF確保PDF生成的執行緒安全性

現在讓我們將IronPDF和volatile關鍵字在C#程式中結合使用。 一個受歡迎的C#程式庫，用於建立和修改PDF文件，叫做IronPDF。 在使用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。 為了在更改_lock的私有物件上。

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

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

C# Volatile (How It Works For Developers): Figure 5

此範例演示了在多執行緒環境中穩健地生成PDF文件的方法，利用IronPDF和volatile關鍵字。 我們通過利用_isRunning標識的變更在執行緒間立即可見，有效地控制了PDF的生成過程。 我們也使用鎖來存取和更改_isRunning標誌，同時保持工人執行緒的安全。

C# Volatile (How It Works For Developers): Figure 6

結論

總之，在IronPDF中融入volatile關鍵字提供了一種有力的方式，以保障在多執行緒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 的執行緒安全？

using 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# 中的執行緒安全 Singleton，volatile 如何幫助？

可以使用 volatile 建立執行緒安全的 Singleton，方法是將實例變數標記為 volatile，並使用雙重檢查鎖定機制以確保即使在多執行緒上下文中也只建立一個實例。

為什麼直接記憶體存取在多執行緒應用程式中很重要？

直接記憶體存取確保了字段的最新值從主記憶體讀取和寫入，防止因快取導致的陳舊資料問題，這在多執行緒應用程式中可能會發生。

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天。
聊天
電子郵件
給我打電話