.NET幫助

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

Q: 如何在C#中修改引用類型變數的參數值？

在C#中，可以使用 ref 關鍵字允許方法修改引用類型變數的參數值。這使得方法可以改變原始變數，而不僅僅是副本。

Q: 在C#中ref和out關鍵字有什麼區別？

ref 關鍵字要求變數在傳遞給方法之前已初始化，而 out 關鍵字不需要事先初始化，但要求方法在返回前賦值。

Q: ref關鍵字可以用於C#中的值類型和引用類型嗎？

是的， ref 關鍵字可以用於值類型（如整數）和引用類型（如對象），允許方法修改實際數據或引用本身。

Q: 在C#中的方法重載中如何使用ref關鍵字？

ref 關鍵字可以用於方法重載來區分方法簽名。這允許根據參數是按引用還是按值傳遞來調用不同的方法。

Q: 如何使用ref關鍵字將.NET PDF庫與C#集成？

您可以將IronPDF與C#集成，通過利用 ref 關鍵字來傳遞和修改表示數據的變量，例如動態更新PDF內容中的值。

Q: 在C#中使用ref關鍵字時應該注意哪些事項？

在C#中使用 ref 關鍵字時，確保變量在傳遞給方法之前已初始化，因為 ref 要求預初始化的變量才能正常工作。

Curtis Chau

更新日期:7月 28, 2025

在 C# 中，ref 關鍵字是一個強大的功能，允許方法修改傳遞的引用類型變量的參數值。理解如何使用 ref 可以增強您在應用程序中管理和操作數據的能力。

本文將引導您了解 ref 關鍵字的基礎知識及其應用，以及在不同數據類型上的使用差異。我們還將學習IronPDF for .NET，一個 PDF 庫。

理解 ref 參數

ref 參數是一個方法參數，作為傳遞到方法中的變量的引用。不同於標準值參數只傳遞變量的副本，ref 參數允許被調用的方法修改原始變量的值。當您需要一個方法更新傳遞給它的變量的狀態時，這種行為是至關重要的。

請考慮以下示例，以演示 ref 的基本使用，著重於如何在方法調用期間，引用類型變量 保留其 參數值 在同一對象中：

class Program
{
    static void Main()
    {
        int number = 100;
        ModifyNumber(ref number);
        Console.WriteLine(number); // Output: 200
    }

    // Method that modifies the original number through 'ref'
    static void ModifyNumber(ref int number)
    {
        number = 200; // Modifies the original value
    }
}

class Program
{
    static void Main()
    {
        int number = 100;
        ModifyNumber(ref number);
        Console.WriteLine(number); // Output: 200
    }

    // Method that modifies the original number through 'ref'
    static void ModifyNumber(ref int number)
    {
        number = 200; // Modifies the original value
    }
}

Friend Class Program
	Shared Sub Main()
		Dim number As Integer = 100
		ModifyNumber(number)
		Console.WriteLine(number) ' Output: 200
	End Sub

	' Method that modifies the original number through 'ref'
	Private Shared Sub ModifyNumber(ByRef number As Integer)
		number = 200 ' Modifies the original value
	End Sub
End Class

$vbLabelText $csharpLabel

在這個例子中，Main 方法聲明了一個整數 number 並將其初始化為 100。然後，它調用 ModifyNumber，把 number 作為 ref 參數傳遞。在 ModifyNumber 中，number 的值被改變為 200。由於 number 是通過引用傳遞的，這一改變反映在 Main 方法的原始值中，並且控制台打印出 200。

ref 參數的工作原理

當您用 ref 關鍵字聲明方法參數時，您告訴編譯器該參數將引用原始變量而不是副本。這是通過傳遞變量的內存地址來實現，而不是實際值。被調用的方法和調用方法都訪問相同的內存位置，這意味著對參數所做的任何更改，都是直接對原始變量進行的。

理解 ref 的關鍵是認識到它可以同時用於值類型和引用類型。值類型包括簡單數據類型如整數和結構體，而引用類型包括對象和數組。然而，即使引用類型變量本質上持有內存地址，但使用 ref 與引用類型可以讓您修改實際的引用，而不僅僅是對象的內容。

ref 與 out 之間的區別

雖然 ref 和 out 關鍵字都允許修改原始變量，但存在重要區別。 out 參數不需要在傳遞給方法前進行初始化。相反，ref 參數要求變量必須在傳遞前初始化。此外，使用 out 參數的方法必須在方法返回前分配一個值。此要求不適用於 ref 參數。

以下是您可能如何使用 out 關鍵字：

class Program
{
    static void Main()
    {
        int result;
        CalculateResult(out result);
        Console.WriteLine(result); // Output: 100
    }

    // Method that calculates a result and assigns it via 'out'
    static void CalculateResult(out int calculation)
    {
        calculation = 20 * 5; // Must initialize the out parameter
    }
}

class Program
{
    static void Main()
    {
        int result;
        CalculateResult(out result);
        Console.WriteLine(result); // Output: 100
    }

    // Method that calculates a result and assigns it via 'out'
    static void CalculateResult(out int calculation)
    {
        calculation = 20 * 5; // Must initialize the out parameter
    }
}

Friend Class Program
	Shared Sub Main()
		Dim result As Integer = Nothing
		CalculateResult(result)
		Console.WriteLine(result) ' Output: 100
	End Sub

	' Method that calculates a result and assigns it via 'out'
	Private Shared Sub CalculateResult(ByRef calculation As Integer)
		calculation = 20 * 5 ' Must initialize the out parameter
	End Sub
End Class

$vbLabelText $csharpLabel

在這種情況下，CalculateResult 在方法中初始化 calculation，而 Main 反映結果。

ref 的實際應用於方法重載

ref 還可以用於方法重載，通過 ref 關鍵字改變方法簽名。方法簽名由方法名稱和其參數類型組成，包括參數是通過引用 (ref)、值傳遞還是作為 out 參數傳遞。

考慮根據 ref 和值參數重載方法：

class Program
{
    static void Main()
    {
        int normalParameter = 10, refParameter = 10;
        IncrementValue(normalParameter);
        IncrementValue(ref refParameter);
        Console.WriteLine($"Normal: {normalParameter}, Ref: {refParameter}"); // Output: Normal: 10, Ref: 11
    }

    // Method that increments a copy of the integer
    static void IncrementValue(int number)
    {
        number++;
    }

    // Method that increments the original integer using 'ref'
    static void IncrementValue(ref int number)
    {
        number++;
    }
}

class Program
{
    static void Main()
    {
        int normalParameter = 10, refParameter = 10;
        IncrementValue(normalParameter);
        IncrementValue(ref refParameter);
        Console.WriteLine($"Normal: {normalParameter}, Ref: {refParameter}"); // Output: Normal: 10, Ref: 11
    }

    // Method that increments a copy of the integer
    static void IncrementValue(int number)
    {
        number++;
    }

    // Method that increments the original integer using 'ref'
    static void IncrementValue(ref int number)
    {
        number++;
    }
}

Friend Class Program
	Shared Sub Main()
		Dim normalParameter As Integer = 10, refParameter As Integer = 10
		IncrementValue(normalParameter)
		IncrementValue(refParameter)
		Console.WriteLine($"Normal: {normalParameter}, Ref: {refParameter}") ' Output: Normal: 10, Ref: 11
	End Sub

	' Method that increments a copy of the integer
'INSTANT VB TODO TASK: VB does not allow method overloads which differ only in parameter ByVal/ByRef:
'ORIGINAL LINE: static void IncrementValue(int number)
	Private Shared Sub IncrementValue(ByVal number As Integer)
		number += 1
	End Sub

	' Method that increments the original integer using 'ref'
'INSTANT VB TODO TASK: VB does not allow method overloads which differ only in parameter ByVal/ByRef:
'ORIGINAL LINE: static void IncrementValue(ref int number)
	Private Shared Sub IncrementValue(ByRef number As Integer)
		number += 1
	End Sub
End Class

$vbLabelText $csharpLabel

這裡，IncrementValue 以一個普通參數和一個 ref 參數的版本進行重載。 ref 版本增量原始變量，而普通版本僅更改一個副本。

IronPDF 简介

C# Ref (它如何為開發者工作)：圖 1

IronPDF for .NET PDF 解決方案是一個全面的 .NET 庫，專門用於處理 PDF 文檔。它主要以 C# 編寫，重點在於簡化從HTML 內容創建和操作 PDF的過程。通過使用 Chrome 渲染引擎，IronPDF 提供高質量、像素完美的 PDF 文檔，捕捉 HTML、CSS、JavaScript 和圖片內容的細微差別。

這個庫用途廣泛，支持多種 .NET 環境，包括 .NET Framework、.NET Core 和 .NET Standard，使其適用於各種應用程序，從桌面到基於網絡的系統。 IronPDF 不僅支持 PDF 創建，還提供編輯、加密、轉換 PDF 到其他格式的功能。

這些功能擴展到提取文本和圖片、填寫表單，甚至應用數字簽名，確保在 .NET 應用程序中全面處理 PDF 文檔。

將 IronPDF 與 C# 和 ref 關鍵字集成

IronPDF 可以與 C# 集成，利用語言的強大功能，包括使用 ref 關鍵字進行參數的引用傳遞。這種集成允許動態 PDF 生成功能，其中內容可能取決於運行時確定值的變量。

為了說明如何將 IronPDF 與 C# 結合使用 ref 關鍵字，請考慮我們希望生成包含動態計算值的 PDF 報告的場景。該值將在接受 ref 參數的方法內計算，允許方法修改此值，然後在生成的 PDF 中反映。

代碼示例：使用 ref 生成具有動態內容的 PDF

以下 C# 代碼演示如何結合 IronPDF 和 ref 關鍵字來生成一個 PDF 文檔。該代碼計算一個值，通過接受 ref 參數的方法進行修改，然後使用 IronPDF 生成包含該動態內容的 PDF。

using IronPdf;
using System;

class Program
{
    static void Main(string[] args)
    {
        // Set your IronPDF license key
        License.LicenseKey = "License-Key";

        // Initialize the value
        int totalSales = 150;

        // Modify the value within the method using 'ref'
        AddMonthlyBonus(ref totalSales);

        // Use IronPDF to generate a PDF report
        var Renderer = new ChromePdfRenderer();
        var PDF = Renderer.RenderHtmlAsPdf($"<h1>Monthly Sales Report</h1><p>Total Sales, including bonus: {totalSales}</p>");

        // Save the PDF to a file
        PDF.SaveAs("MonthlySalesReport.pdf");

        // Confirm the PDF has been generated
        Console.WriteLine("PDF generated successfully. Check your project directory.");
    }

    // Method that adds a monthly bonus to sales using 'ref'
    static void AddMonthlyBonus(ref int sales)
    {
        // Assume a bonus of 10% of the sales
        sales += (int)(sales * 0.1);
    }
}

using IronPdf;
using System;

class Program
{
    static void Main(string[] args)
    {
        // Set your IronPDF license key
        License.LicenseKey = "License-Key";

        // Initialize the value
        int totalSales = 150;

        // Modify the value within the method using 'ref'
        AddMonthlyBonus(ref totalSales);

        // Use IronPDF to generate a PDF report
        var Renderer = new ChromePdfRenderer();
        var PDF = Renderer.RenderHtmlAsPdf($"<h1>Monthly Sales Report</h1><p>Total Sales, including bonus: {totalSales}</p>");

        // Save the PDF to a file
        PDF.SaveAs("MonthlySalesReport.pdf");

        // Confirm the PDF has been generated
        Console.WriteLine("PDF generated successfully. Check your project directory.");
    }

    // Method that adds a monthly bonus to sales using 'ref'
    static void AddMonthlyBonus(ref int sales)
    {
        // Assume a bonus of 10% of the sales
        sales += (int)(sales * 0.1);
    }
}

Imports IronPdf
Imports System

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Set your IronPDF license key
		License.LicenseKey = "License-Key"

		' Initialize the value
		Dim totalSales As Integer = 150

		' Modify the value within the method using 'ref'
		AddMonthlyBonus(totalSales)

		' Use IronPDF to generate a PDF report
		Dim Renderer = New ChromePdfRenderer()
		Dim PDF = Renderer.RenderHtmlAsPdf($"<h1>Monthly Sales Report</h1><p>Total Sales, including bonus: {totalSales}</p>")

		' Save the PDF to a file
		PDF.SaveAs("MonthlySalesReport.pdf")

		' Confirm the PDF has been generated
		Console.WriteLine("PDF generated successfully. Check your project directory.")
	End Sub

	' Method that adds a monthly bonus to sales using 'ref'
	Private Shared Sub AddMonthlyBonus(ByRef sales As Integer)
		' Assume a bonus of 10% of the sales
		sales += CInt(Math.Truncate(sales * 0.1))
	End Sub
End Class

$vbLabelText $csharpLabel

C# Ref (它如何為開發者工作)：圖 2

在這個例子中，totalSales 起始值為 150。AddMonthlyBonus 方法通過使用 ref 關鍵字按引用取這個值，計算 10% 的獎金，然後將其加到原始銷售值。 IronPDF 隨後生成一個包含報告總銷售額（包括獎金）的 HTML 片段的 PDF 文檔。最終文檔本地保存為 “MonthlySalesReport.pdf”。