.NET 帮助

C# 引用传递（开发人员如何使用）

发布 2024年八月13日

介绍

在编程世界中，有效的内存管理和数据操作是构建高性能代码的基本组成部分。编写高效且无错误的代码需要理解数据是如何传输在像C#这样的语言中，方法和函数之间。这个过程中一个关键的概念是“引用传递”。在本文中，我们将探讨C#中引用传递的含义及其适用的使用场景。

如何使用C#引用传递

定义带有ref参数的方法。
初始化变量。
使用ref关键字调用方法。
在方法内部修改变量。
在主方法中观察变化。
定义另一个带有out参数的方法以生成PDF。
初始化并调用out方法。

什么是 C# 中的引用传递？

利用引用传递指的是在 C# 中通过向函数或方法传递初始变量的引用，而不是其值的副本，从而传递参数的方式。这意味着在方法内部对参数所做的任何更改也会影响方法外部的初始变量。

C# 中的值类型变量 (例如 int、float、bool 等等。) 通常是按值传递的，这是一个引用参数，意味着方法接收到变量值的副本。不过，你可以使用 ref 关键字告诉编译器通过引用传递参数。

使用 ref 关键字

在 C# 中，可以使用 ref 关键字通过引用传递引用参数。使用 ref 关键字通过引用传递的参数所做的任何修改都会影响原始变量。

class Program
{
    static void Main(string[] args)
    {
        int num = 10;
        Console.WriteLine("Before: " + num); // Output: Before: 10
        ModifyByRef(ref num);
        Console.WriteLine("After: " + num);  // Output: After: 20
    }
    static void ModifyByRef(ref int x)
    {
        x = x * 2;
    }
}

class Program
{
    static void Main(string[] args)
    {
        int num = 10;
        Console.WriteLine("Before: " + num); // Output: Before: 10
        ModifyByRef(ref num);
        Console.WriteLine("After: " + num);  // Output: After: 20
    }
    static void ModifyByRef(ref int x)
    {
        x = x * 2;
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

上面示例中的 ModifyByRef 方法使用了 ref 关键字通过引用获取整数参数 x。在方法内部对 ref 参数 x 所做的任何修改，在使用 ref num 调用方法时会对方法外部的 num 变量产生直接影响。

out 关键字

out 关键字用于通过引用将参数传递给调用方法，就像 ref 一样。因此，方法能够返回多个值。

class Program
{
    static void Main(string[] args)
    {
        int result;
        Calculate(10, 5, out result);
        Console.WriteLine("Result: " + result); // Output: Result: 15
    }
    static void Calculate(int x, int y, out int result)
    {
        result = x + y;
    }
}

class Program
{
    static void Main(string[] args)
    {
        int result;
        Calculate(10, 5, out result);
        Console.WriteLine("Result: " + result); // Output: Result: 15
    }
    static void Calculate(int x, int y, out int result)
    {
        result = x + y;
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

在这个例子中，两个整数参数 x 和 y 以及一个由 out 关键字表示的额外参数 result 被传递给 Calculate 方法。在过程计算 x 和 y 的和之后，结果被分配给 result 参数。由于它被标记为 out，result 在传递给方法之前不需要初始化。

何时使用引用传递

编写高效且可维护的代码需要知道何时使用引用传递。以下情况需要使用多个引用传递值：

修改多个变量

通过引用传递参数可能在一个方法需要更改多个变量并且这些更改需要在方法外反映时很有帮助。与其让过程返回多个值，不如通过引用发送变量并在方法内直接更改它们。

static void ModifyMultipleByRef(ref int a, ref int b)
{
    a *= 2;
    b *= 3;
}

static void ModifyMultipleByRef(ref int a, ref int b)
{
    a *= 2;
    b *= 3;
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

大数据结构

通过防止不必要的数据重复，通过引用传递参数来传递大数据结构（如数组或复杂对象）可以提高效率。然而，在处理巨大数据结构时，应该谨慎使用引用传递，因为如果处理不当，可能会产生意想不到的后果。

与外部代码的互操作性

在与外部库交互或集成本地代码时，可能需要通过引用传递参数，以遵守方法定义和外部代码的要求。

什么是 IronPDF？

C# 库 IronPDF 允许程序员在 .NET 应用程序中创建、修改和渲染 PDF 文档。其庞大的功能集合使处理 PDF 文件变得简单。你可以通过 HTML、照片和其他格式创建 PDF 文档；使用文本、图像和其他数据注释 PDF；并拆分、合并和编辑现有的 PDF 文档。

IronPDF 的主要功能是其转换能力 HTML 转 PDF确保布局和样式得以保留。这功能非常适用于从基于网络的内容生成PDF，如报告、发票和文档。它将HTML文件、URL和HTML字符串转换为PDF文件。

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

		' 1. Convert HTML String to PDF
		Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"
		Dim pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent)
		pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf")

		' 2. Convert HTML File to PDF
		Dim htmlFilePath = "path_to_your_html_file.html" ' Specify the path to your HTML file
		Dim pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath)
		pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf")

		' 3. Convert URL to PDF
		Dim url = "http://ironpdf.com" ' Specify the URL
		Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
		pdfFromUrl.SaveAs("URLToPDF.pdf")
	End Sub
End Class

VB C#

IronPDF 的功能

文本和图像标注

IronPDF 允许您以编程方式向 PDF 文档添加文本、图像和注释。借助此功能，您可以使用签名、印章和备注来标注 PDF 文件。

PDF安全性

IronPDF允许您指定不同的权限，包括打印、复制内容和编辑文档，并且可以用密码加密PDF文档。这有助于您控制对PDF文件的访问和保护敏感数据。

填写交互式 PDF 表单

IronPDF 允许您以编程方式填写交互式 PDF 表单。这种功能对于使用用户输入创建自定义文档或自动提交表单非常有用。

PDF 压缩和优化

为了在不牺牲质量的前提下尽量减少文件大小，IronPDF 提供了 PDF 文件的压缩和优化解决方案。这不仅减少了 PDF 文档所需的存储空间，还提高了性能。

跨平台兼容性

IronPDF 专为与面向 Windows、Linux 和 macOS 等平台的 .NET 应用程序完美运行而设计。它集成了流行的 .NET 框架，如 ASP.NET、.NET Core 和 Xamarin。

创建一个新的Visual Studio项目

使用Visual Studio创建一个控制台项目很容易。要创建一个控制台应用程序，请在Visual Studio中执行以下操作：

在开始之前 Visual Studio请确保您已在计算机上安装它。

开始一个新项目

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

C# 引用传递（它是如何为开发者工作的）：图1

在“创建新项目”框的左侧，选择您偏好的编程语言。 (例如 C#)"控制台应用" 或 "控制台应用 (.NET Core)模板可以从以下项目模板的参考类型列表中选择。

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

C# 引用传递（开发人员如何使用）：图2

选择您希望存储项目的存储位置。

按“创建”以启动控制台应用程序项目。

C# 引用传递（开发人员如何使用）：图 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

相关搜索结果列表可以在上面的图片中看到。为了在您的机器上安装该软件，请调整这些设置。

一旦下载并安装了软件包，它现在可以在当前的项目中使用。

使用引用传递与IronPDF

这是如何使用IronPDF的引用传递功能的示例。

using IronPdf;
using System;
class Program
{
    static void Main(string[] args)
    {
        // Create a PDF document
        var pdf = new IronPdf.HtmlToPdf();
        // HTML content to be converted to PDF
        string htmlContent = "<h1>Hello, IronPDF!</h1>";
        // Create a byte array to store the PDF content
        byte[] pdfBytes;
        // Convert HTML to PDF and pass the byte array by reference
        ConvertHtmlToPdf(pdf, htmlContent, out pdfBytes);
        // Save or process the PDF content
        // For demonstration, let's print the length of the PDF content
        Console.WriteLine("Length of PDF: " + pdfBytes.Length);
    }
    static void ConvertHtmlToPdf(IronPdf.HtmlToPdf pdfConverter, string htmlContent, out byte[] pdfBytes)
    {
        // Convert HTML to PDF and store the result in the byte array
        var pdfDoc = pdfConverter.RenderHtmlAsPdf(htmlContent);
        pdfBytes = pdfDoc.BinaryData;
    }
}

using IronPdf;
using System;
class Program
{
    static void Main(string[] args)
    {
        // Create a PDF document
        var pdf = new IronPdf.HtmlToPdf();
        // HTML content to be converted to PDF
        string htmlContent = "<h1>Hello, IronPDF!</h1>";
        // Create a byte array to store the PDF content
        byte[] pdfBytes;
        // Convert HTML to PDF and pass the byte array by reference
        ConvertHtmlToPdf(pdf, htmlContent, out pdfBytes);
        // Save or process the PDF content
        // For demonstration, let's print the length of the PDF content
        Console.WriteLine("Length of PDF: " + pdfBytes.Length);
    }
    static void ConvertHtmlToPdf(IronPdf.HtmlToPdf pdfConverter, string htmlContent, out byte[] pdfBytes)
    {
        // Convert HTML to PDF and store the result in the byte array
        var pdfDoc = pdfConverter.RenderHtmlAsPdf(htmlContent);
        pdfBytes = pdfDoc.BinaryData;
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

在此示例中，ConvertHtmlToPdf 函数接受三个参数：HTML 内容、一个名为 pdfBytes 的字节数组和一个 IronPDF HtmlToPdf 对象。out 关键字表示 pdfBytes 参数是通过引用提供的，并将在方法中改变。

C# 引用传递（开发人员如何使用）：图 5

HTML 内容在 ConvertHtmlToPdf 函数中使用 IronPDF 渲染为 PDF 文档，生成的二进制数据存储在 pdfBytes 数组中。

我们使用将Html转换为Pdf 再次在主函数中，通过引用传递 pdfBytes 数组。方法调用后，IronPDF 的 PDF 内容存储在 pdfBytes 数组的内存位置。

C# 引用传递（对开发者的工作原理）：图6

这向您展示了如何使用IronPDF和C#中的传引用以有效的方式创建和处理PDF文档。

结论

总的来说，在C#中使用IronPDF的引用传递功能可以极大地提升.NET程序中创建和修改PDF文档的能力。有效使用ref和out关键字使开发人员能够轻松地通过引用传递参数，从而快速高效地在方法内修改变量和内容。IronPDF广泛的功能，包括将HTML转化为PDF、基于图像生成PDF以及执行广泛的PDF修改任务，使开发人员能够轻松构建动态和互动的PDF文档。

IronPDF提供了加速文档处理流程所需的工具和API，包括拆分、合并、注释和优化PDF文件等。此外，PDF的跨平台互操作性保证了C#应用程序可以在各种环境中轻松整合PDF功能。本质上，通过将C#的引用传递强大功能与IronPDF丰富的特性结合起来，开发人员可以在其应用程序中开辟创建、修改和显示PDF文档的新途径。

最后，通过包含IronPDF，你可以高效地处理Excel、生成PDF、执行OCR以及使用条形码。铁软件（Iron Software）价格从$749起。开发人员可以放心地选择最佳模型，因为有清晰的许可选项可以根据项目需求量身定制。凭借这些优势，开发人员可以高效透明地解决各种挑战。

< 前一页
NServiceBus C#（开发人员如何使用）

下一步 >
EasyNetQ .NET（开发人员的工作原理）