.NET 幫助

C# 引用传递（對開發者的運作方式）

發佈 2024年8月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 num 調用時，對方法內的 ref 參數 x 所做的任何修改都會立即影響方法外的 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 方法。結果被分配給 result 參數後，這個過程會計算出 x 和 y 的總和。結果不需要在發送給方法之前進行初始化，因為它被標記為 out。

何时使用引用传递

编写高效且可维护的代码需要了解什么时候使用引用传递。在以下情况中，需要使用多个引用传递的值：

修改多個變數

通過引用傳遞參數可能會有所幫助，當方法需要更改多個變數並且這些變更需要在方法外部反映出來時，這種方式很有用。與其讓程式返回多個值，不如通過引用傳遞變數，在方法內直接更改它們。

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 應用程序。它與 ASP.NET、.NET Core 和 Xamarin 等流行的 .NET 框架集成。

建立新的 Visual Studio 專案

使用 Visual Studio 建立主控台專案非常容易。要建立主控台應用程式，請在 Visual Studio 中執行以下操作：

在開始前 Visual Studio，請確保您已安裝在您的電腦上。

開始一個新專案

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

C# 引用類型的傳遞 (開發人員如何使用): 圖1

在「創建新專案」框的左側，選擇您偏好的程式語言 (例如 C#)控制台應用程式 (.NET Core)範本可以從以下專案範本的參考類型列表中選擇。

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

C# 以參考傳遞（給開發人員的運作原理）：圖2

選擇您希望儲存專案的存儲位置。

按下「建立」來啟動主控台應用程式專案。

C# 引用傳遞（開發者如何使用）：圖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# 參考傳遞（開發人員如何操作）：圖 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內容透過IronPDF的ConvertHtmlToPdf功能渲染為PDF文件，生成的二進制數據存儲在pdfBytes數組中。

我們使用將Html轉換為Pdf 再次在 Main 函數中，通過引用傳遞 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以及使用條碼。 IronSoftware 價格從 $749 起。開發人員可以有信心地選擇最適合的模型，如果有明確的許可選項針對專案需求量身定制。藉由這些優勢，開發人員可以有效且透明地解決各種挑戰。

< 上一頁
NServiceBus C＃（如何為開發人員工作）

下一個 >
EasyNetQ .NET（對開發者來說如何運作）