1. IronPDF
  2. IronPDF博客
  3. .NET 帮助
  4. C# volatile
.NET 帮助

C# Volatile（开发人员如何使用）

发布 2024年八月13日
分享:

介绍

在 C# 中，volatile 关键字用于表示一个字段可能会被并发执行的线程更新。被标记为 波动的 警告编译器和运行时，警告并发线程或其他程序组件可能会在没有警告的情况下更改字段的值。这保证了对该字段的内存访问不会被编译器优化掉，从而导致意外行为。 多线程应用程序一种深受欢迎的用于创建和修改PDF文档的C#库被称为 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的字段的每一次读写内存操作都会避免使用任何可能的缓存方法。这意味着对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。像 ASP.NET、NET Core 和 Xamarin 这样的知名 .NET 框架都与它集成在一起。

创建一个新的 Visual Studio 项目

在 Visual Studio 中创建一个控制台项目是一个简单的过程。要启动一个控制台应用程序，请在 Visual Studio 环境中按照以下简单步骤操作：

在使用 Visual Studio 之前，请确保它已安装在您的计算机上。

开始一个新项目

选择文件，然后新建，最后选择项目。

C# 易失性（它如何为开发人员工作）：图1

在“创建新项目”框中，选择您偏好的编程语言 (例如，C# ) 从左边的列表中。

以下项目模板参考列表中有“控制台应用”或“控制台应用”。 (.NET Core)" 可选择的模板。

在“名称”字段中为您的项目提供名称。

C# Volatile（它如何为开发人员工作）：图2

选择项目存放位置。

点击“Create”将启动控制台应用程序项目。

C# Volatile（开发人员如何使用）：图3

安装 IronPDF

在工具菜单下的 Visual Studio 工具菜单项包含 Visual 命令行界面。选择 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# 易变性（它如何为开发人员工作）：图 4 - 从 NuGet 包管理器安装 IronPDF

相关的搜索结果显示在上面的图像中。请进行以下更改，以便该软件更容易安装在您的计算机上。

下载并安装软件包后，我们现在可以在正在进行的项目中使用它。

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

现在让我们在 C# 程序中一起使用 IronPDF 和 volatile 关键字。IronPDF 是一个为创建和修改 PDF 文档而广受欢迎的 C# 库。在使用 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(字符串 filePath)**：这个函数启动一个新的线程，按计划创建PDF文档。我们在主线程内不断检查isRunning标志。如果是，我们使用IronPDF创建一个 PDF 文档 并将其保存到指定的文件目录。

StopPdfGeneration()**此功能使得可以暂停PDF的创建。为了在更改isRunning标志时保持线程安全，它锁定在一个名为lock的私有对象上。

GenerateDocument(字符串 filePath)：此功能包含使用IronPDF创建PDF文档的必要代码。创建了一个HtmlToPdf实例，加载HTML信息，将其转换为PDF文档，并将PDF保存到指定的文件目录。

Main(字符串[] 参数)：在Main方法中实例化PdfGenerator类，启动PDF生成，并提示用户按任意键停止PDF生成。

C# Volatile（它是如何为开发人员工作的）：图5

这个示例展示了如何在多线程环境中使用IronPDF和volatile关键字可靠地生成PDF文档。我们通过使用volatile关键字有效地控制PDF创建过程，以确保对isRunning标志的更改在各线程中立即可见。我们还使用锁来访问和修改isRunning标志，同时保持工作线程的安全性。

C# Volatile（对开发人员的工作原理）：图 6

结论

总而言之，在 IronPDF 中加入 volatile 关键字，提供了一种保证线程安全的强大方式，用于在多线程 C# 程序中创建 PDF。我们通过将共享控制标志指定为 volatile 来确保线程对变化的及时感知和适当的同步，从而有效地控制 PDF 生成过程。

通过确保对控制标志的更改即时广播到所有线程，volatile 用于避免冲突并促进 PDF 创建过程中各个环节的有效协调。

这种方法提高了在并发环境中生成 PDF 的可扩展性和可靠性，使应用程序可以同时有效地管理多个 PDF 生成过程，而不会有数据损坏或竞争情况的风险。

最后，通过包含 IronPDF，您可以有效地处理条形码、创建 PDF、执行 OCR、并与 Excel 连接。 铁软件（Iron Software） 将IronSoftware的多功能套件的性能、兼容性和易用性轻松结合起来，提供增强的应用能力和更有效的开发。

如果有明确的许可选项为特定项目需求量身定制，开发人员可以有信心地选择最佳模型。这些优势使开发人员能够高效透明地解决各种挑战。

< 前一页
C# TryParse（开发人员如何使用）
下一步 >
C# Task.Run（它是如何为开发人员工作的）

报告问题

准备开始了吗？ 版本： 2024.9 刚刚发布

免费NuGet下载 总下载量: 10,731,156 查看许可证 >

获取您的免费

30天试用密钥 立即。

15天试用密钥 立即。

bullet_checked无需信用卡或创建账户
试用表格已提交
成功地。

您的试用密钥应在电子邮件中。
如果不是，请联系
support@ironsoftware.com

子弹测试测试生产环境
无水印
子弹日历30天全功能使用
功能性产品
子弹支持24/5技术支持
试用期间的支持

谢谢！

您的许可证密钥已发送到所提供的电子邮件。联系我们

24小时升级优惠：

Save 50% 在一个
专业 升级

去 专业 支持10位开发者
和无限项目。

小时

:

分钟

:

秒

升级到Professional

升级

专业

$600 美元

$299 美元

  • 10位开发者
  • 10个位置
  • 10个项目
今天 只有

5个.NET产品，两件的价格

IronPDF IronOCR IronXL IronBarcode IronWebscraper

套件总价值：

$7,192 美元

升级价格

今天
只有

$499 美元

24小时后

$1,098 美元