我如何在我的專案中有效地使用 C# ref 關鍵字？

C# ref 關鍵字可用於按引用傳遞引數，允許在方法中進行的更改影響原始變數。當您需要修改原始資料時，這尤其有用，例如更新物件的屬性或增加數值。

在什麼場景下 C# ref 關鍵字可以優化性能？

在涉及大量資料操作的場景中使用 ref 關鍵字可以優化性能，因為它允許方法直接作用於原始資料而不需要製作副本。這種效率在處理複雜資料處理任務時尤為重要。

ref 關鍵字與 C# 中的 out 關鍵字有何不同？

ref 關鍵字要求變數在傳遞給方法之前必須初始化，允許該方法修改其值。相反，out 關鍵字不需要在傳遞前初始化，因為該方法將為其賦予新值。

C# 中的 ref 關鍵字可以與異步方法一起使用嗎？

不，C# 中的 ref 關鍵字不能與異步方法一起使用。異步方法要求參數按值傳遞，使用 ref 會違反此要求，導致編譯錯誤。

using ref 關鍵字的潛在陷阱是什麼？

潛在的陷阱包括如果錯誤使用 ref 可能導致程式碼混亂和意外行為。重要的是確保變數在用 ref 傳遞之前正確初始化，以避免運行時錯誤。

理解 ref 關鍵字如何使 C# 開發者受益？

理解 ref 關鍵字對 C# 開發者至關重要，因為它允許更有效的記憶體管理和資料操作。它還增強了編寫易於維護且高效程式碼的能力，特別是在處理複雜資料結構時。

哪些高級工具可以補充 C# ref 在應用開發中的使用？

IronPDF、IronXL、IronOCR 和 IronBarcode 等高級工具可以通過提供專業的 PDF 處理、Excel 操作、光學字元識別和條碼操作功能來補充 ref 關鍵字的使用，從而提升整體的 C# 應用開發。

方法重載如何在 C# 中與 ref 關鍵字一起工作？

C# 中的方法重載允許多個方法具有相同的名稱但不同的參數。當與 ref 關鍵字結合使用時，它允許這些方法直接修改原始變數，提供強大的方式來在重載方法中操作資料。

How can using the ref keyword influence performance in C# applications?

Using the ref keyword can improve performance by reducing the overhead of copying large value types, enabling direct modifications, and minimizing memory usage when working with large data structures.

Why might a developer use the Iron Suite for C# applications?

A developer might use the Iron Suite to leverage its powerful libraries that simplify tasks such as PDF processing, Excel manipulation, and OCR. These tools enhance productivity and efficiency in application development.

C# PDF程式庫

Explore IronPDF 開始免費試用

HTML 轉 PDF

Online Demo 查看所有程式碼範例

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

PM >Install-Package IronPdf

Install-Package IronPdf

開發者更新

C# Ref 關鍵字（開發者的工作原理）

Jacob Mellor

Updated: 2026年1月18日

C# ref 關鍵字是每個初學者應該了解的重要工具。它用於以參考而非值的方式傳遞參數，允許對被調用方法中的參考型變數所做的更改在它之外反映出來。在本教程中，我們將通過多個控制台程式碼範例，深入了解 ref 關鍵字及其工作方式。

ref 關鍵字介紹

在C#中傳遞方法參數時，預設情況下是按值傳遞的。這意味著會建立一個參數值的副本，並且被調用方法中所做的更改不會影響方法之外的原始變數。 ref 關鍵字改變了這種行為，允許您按參考傳遞參數。當參數是通過引用傳遞的時候，方法內所做的任何更改將直接影響方法之外的原始變數。

關鍵概念

ref 關鍵字： 用於表示變數是以參考方式傳遞的。
參考變數： 引用儲存資料所在的記憶體位置的型別。
值型別： 用於保存實際資料的型別。
原始變數： 使用 ref 關鍵字時在方法之外反映變更的變數。

通過引用傳遞

讓我們從了解如何通過引用傳遞變數的概念開始。假設您有一個方法用於增加一個整數，如以下程式碼所示：

class Program
{
    // Method increments the given integer by one
    static void IncrementByOne(int num)
    {
        num++;
    }

    static void Main()
    {
        int value = 5;
        IncrementByOne(value);
        Console.WriteLine(value);  // Output: 5
    }
}

class Program
{
    // Method increments the given integer by one
    static void IncrementByOne(int num)
    {
        num++;
    }

    static void Main()
    {
        int value = 5;
        IncrementByOne(value);
        Console.WriteLine(value);  // Output: 5
    }
}

Friend Class Program
	' Method increments the given integer by one
	Private Shared Sub IncrementByOne(ByVal num As Integer)
		num += 1
	End Sub

	Shared Sub Main()
		Dim value As Integer = 5
		IncrementByOne(value)
		Console.WriteLine(value) ' Output: 5
	End Sub
End Class

Friend Class Program
	' Method increments the given integer by one
	Private Shared Sub IncrementByOne(ByVal num As Integer)
		num += 1
	End Sub

	Shared Sub Main()
		Dim value As Integer = 5
		IncrementByOne(value)
		Console.WriteLine(value) ' Output: 5
	End Sub
End Class

在上面的程式碼中，即使我們在 IncrementByOne 方法中增加了 num，原始 value 仍然保持不變。這是因為 num 是原始變數的副本，對其所做的更改不會影響到原始變數。

使用 ref 關鍵字

現在，讓我們看看 ref 關鍵字如何改變這一行為。通過使用 ref，您可以將變數以引用方式傳遞給方法，如以下程式碼範例之一所示。

class Program
{
    // Method increments the given integer by one using ref
    static void IncrementByOneRef(ref int num)
    {
        num++;
    }

    static void Main()
    {
        int value = 5;
        IncrementByOneRef(ref value);
        Console.WriteLine(value);  // Output: 6
    }
}

class Program
{
    // Method increments the given integer by one using ref
    static void IncrementByOneRef(ref int num)
    {
        num++;
    }

    static void Main()
    {
        int value = 5;
        IncrementByOneRef(ref value);
        Console.WriteLine(value);  // Output: 6
    }
}

Friend Class Program
	' Method increments the given integer by one using ref
	Private Shared Sub IncrementByOneRef(ByRef num As Integer)
		num += 1
	End Sub

	Shared Sub Main()
		Dim value As Integer = 5
		IncrementByOneRef(value)
		Console.WriteLine(value) ' Output: 6
	End Sub
End Class

Friend Class Program
	' Method increments the given integer by one using ref
	Private Shared Sub IncrementByOneRef(ByRef num As Integer)
		num += 1
	End Sub

	Shared Sub Main()
		Dim value As Integer = 5
		IncrementByOneRef(value)
		Console.WriteLine(value) ' Output: 6
	End Sub
End Class

請注意，在方法簽名和調用中都出現 ref 關鍵字。這告訴C#您希望以引用方式傳遞 value 變數。因此，在 IncrementByOneRef 方法中所做的更改將反映在原始 value 變數中。

處理值型別

ref 關鍵字在處理如整數、小數和結構等型別時特別有用。這些型別是直接儲存在記憶體中的，通過引用方式傳遞它們可以提升性能，並對資料操作提供更精確的控制。

修改參考變數

雖然 ref 關鍵字通常與值型別相關，但它也可以用於參考型別變數。參考型別，如類別和陣列，儲存的是指向實際資料的引用，而不是資料本身。這意味著您正在處理類似指標的結構，並通過引用方式傳遞可以產生不同的結果，如以下例子所示：

class Person
{
    public string Name { get; set; }
}

class Program
{
    // Method changes the reference of the person variable to a new Person object
    static void ChangeName(ref Person person)
    {
        person = new Person { Name = "Alice" };
    }

    static void Main()
    {
        Person person = new Person { Name = "Bob" };
        ChangeName(ref person);
        Console.WriteLine(person.Name);  // Output: Alice
    }
}

class Person
{
    public string Name { get; set; }
}

class Program
{
    // Method changes the reference of the person variable to a new Person object
    static void ChangeName(ref Person person)
    {
        person = new Person { Name = "Alice" };
    }

    static void Main()
    {
        Person person = new Person { Name = "Bob" };
        ChangeName(ref person);
        Console.WriteLine(person.Name);  // Output: Alice
    }
}

Friend Class Person
	Public Property Name() As String
End Class

Friend Class Program
	' Method changes the reference of the person variable to a new Person object
	Private Shared Sub ChangeName(ByRef person As Person)
		person = New Person With {.Name = "Alice"}
	End Sub

	Shared Sub Main()
		Dim person As New Person With {.Name = "Bob"}
		ChangeName(person)
		Console.WriteLine(person.Name) ' Output: Alice
	End Sub
End Class

Friend Class Person
	Public Property Name() As String
End Class

Friend Class Program
	' Method changes the reference of the person variable to a new Person object
	Private Shared Sub ChangeName(ByRef person As Person)
		person = New Person With {.Name = "Alice"}
	End Sub

	Shared Sub Main()
		Dim person As New Person With {.Name = "Bob"}
		ChangeName(person)
		Console.WriteLine(person.Name) ' Output: Alice
	End Sub
End Class

在此範例中，ChangeName 方法將 person 變數的引用更改為新的 Person 物件。結果是，原始的 person 變數現在指向不同的物件，其名稱是"Alice"。

方法重載與參考型別參數

您可以有多個擁有相同名稱但參數不同的方法。這稱為方法重載。當使用 ref 關鍵字時，方法重載變得更強大。

class Calculator
{
    // Method adds two integers and modifies the first using ref
    public static void Add(ref int x, int y)
    {
        x += y;
    }

    // Method adds two doubles and modifies the first using ref
    public static void Add(ref double x, double y)
    {
        x += y;
    }
}

class Program
{
    static void Main()
    {
        int intValue = 5;
        double doubleValue = 7.5;

        // Call overloaded Add methods with ref parameters
        Calculator.Add(ref intValue, 3);
        Calculator.Add(ref doubleValue, 2.5);

        Console.WriteLine(intValue);      // Output: 8
        Console.WriteLine(doubleValue);   // Output: 10.0
    }
}

class Calculator
{
    // Method adds two integers and modifies the first using ref
    public static void Add(ref int x, int y)
    {
        x += y;
    }

    // Method adds two doubles and modifies the first using ref
    public static void Add(ref double x, double y)
    {
        x += y;
    }
}

class Program
{
    static void Main()
    {
        int intValue = 5;
        double doubleValue = 7.5;

        // Call overloaded Add methods with ref parameters
        Calculator.Add(ref intValue, 3);
        Calculator.Add(ref doubleValue, 2.5);

        Console.WriteLine(intValue);      // Output: 8
        Console.WriteLine(doubleValue);   // Output: 10.0
    }
}

Friend Class Calculator
	' Method adds two integers and modifies the first using ref
	Public Shared Sub Add(ByRef x As Integer, ByVal y As Integer)
		x += y
	End Sub

	' Method adds two doubles and modifies the first using ref
	Public Shared Sub Add(ByRef x As Double, ByVal y As Double)
		x += y
	End Sub
End Class

Friend Class Program
	Shared Sub Main()
		Dim intValue As Integer = 5
		Dim doubleValue As Double = 7.5

		' Call overloaded Add methods with ref parameters
		Calculator.Add(intValue, 3)
		Calculator.Add(doubleValue, 2.5)

		Console.WriteLine(intValue) ' Output: 8
		Console.WriteLine(doubleValue) ' Output: 10.0
	End Sub
End Class

Friend Class Calculator
	' Method adds two integers and modifies the first using ref
	Public Shared Sub Add(ByRef x As Integer, ByVal y As Integer)
		x += y
	End Sub

	' Method adds two doubles and modifies the first using ref
	Public Shared Sub Add(ByRef x As Double, ByVal y As Double)
		x += y
	End Sub
End Class

Friend Class Program
	Shared Sub Main()
		Dim intValue As Integer = 5
		Dim doubleValue As Double = 7.5

		' Call overloaded Add methods with ref parameters
		Calculator.Add(intValue, 3)
		Calculator.Add(doubleValue, 2.5)

		Console.WriteLine(intValue) ' Output: 8
		Console.WriteLine(doubleValue) ' Output: 10.0
	End Sub
End Class

在上述範例中，我們對 Add 方法進行重載，以處理 int 和 double 兩種型別。ref 關鍵字允許方法直接修改原始變數。

使用 out 關鍵字

另一個相關的關鍵字是 out。它類似於 ref ，但用途略有不同。 ref 需要在變數被傳遞之前初始化，而 out 關鍵字用於在您希望方法將值賦給一個不一定有初始值的參數時：

class Program
{
    // Method computes the quotient and uses the out keyword to return it
    static void Divide(int dividend, int divisor, out int quotient)
    {
        quotient = dividend / divisor;
    }

    static void Main()
    {
        int result;
        Divide(10, 2, out result);
        Console.WriteLine(result);  // Output: 5
    }
}

class Program
{
    // Method computes the quotient and uses the out keyword to return it
    static void Divide(int dividend, int divisor, out int quotient)
    {
        quotient = dividend / divisor;
    }

    static void Main()
    {
        int result;
        Divide(10, 2, out result);
        Console.WriteLine(result);  // Output: 5
    }
}

Friend Class Program
	' Method computes the quotient and uses the out keyword to return it
	Private Shared Sub Divide(ByVal dividend As Integer, ByVal divisor As Integer, ByRef quotient As Integer)
		quotient = dividend \ divisor
	End Sub

	Shared Sub Main()
		Dim result As Integer = Nothing
		Divide(10, 2, result)
		Console.WriteLine(result) ' Output: 5
	End Sub
End Class

Friend Class Program
	' Method computes the quotient and uses the out keyword to return it
	Private Shared Sub Divide(ByVal dividend As Integer, ByVal divisor As Integer, ByRef quotient As Integer)
		quotient = dividend \ divisor
	End Sub

	Shared Sub Main()
		Dim result As Integer = Nothing
		Divide(10, 2, result)
		Console.WriteLine(result) ' Output: 5
	End Sub
End Class

在此範例中，Divide 方法計算商數並使用 out 關鍵字將其賦給 quotient 變數。值得注意的是，您無需在將 result 傳遞給方法之前對其進行初始化。

ref 和 out 關鍵字的區別

out 關鍵字類似於 ref 關鍵字，但有顯著不同。 out 參數不需要初始值，而 ref 參數則必須在方法調用之前有初始值。

潛在的陷阱

雖然 ref 和 out 關鍵字可以是強大工具，但應謹慎使用。不正確使用這些關鍵字可能導致混淆的程式碼和意外的行為。例如，您不能在 ref 或 out 參數中使用未初始化的非-ref 變數，這會導致編譯錯誤。

ref 關鍵字的高級用法

處理參考型別和值型別

了解參考型別和值型別之間的區別對於使用 ref 關鍵字至關重要。

參考型別： 變數指的是記憶體中儲存資料的位置，例如物件、陣列等。
值型別： 變數直接包含資料，例如整數、浮點數等。 using ref 處理值型別允許變更反映在方法外，參考型別變數本質上會這樣行為。

ref 關鍵字的擴展方法

您還可以將 ref 關鍵字用於擴展方法。一個範例：

public static class StringExtensions
{
    // Extension method that appends a value to the input string
    public static void AppendValue(ref this string input, string value)
    {
        input += value;
    }
}

public static class StringExtensions
{
    // Extension method that appends a value to the input string
    public static void AppendValue(ref this string input, string value)
    {
        input += value;
    }
}

Public Module StringExtensions
	' Extension method that appends a value to the input string
	Public Sub AppendValue(ByRef Me input As String, ByVal value As String)
		input &= value
	End Sub
End Module

Public Module StringExtensions
	' Extension method that appends a value to the input string
	Public Sub AppendValue(ByRef Me input As String, ByVal value As String)
		input &= value
	End Sub
End Module

編譯器錯誤與 ref 關鍵字

如果您在方法簽名或方法調用中忘記了 ref 關鍵字，這將導致編譯時的編譯器錯誤。

`Async` 方法與 ref 參數

注意，您不能將 ref 參數用於迭代器方法或 async 方法，因為這些方法需要按值傳遞參數。

介紹 Iron Suite

除了理解 C# 中的 ref 關鍵字等關鍵概念外，還有一套強大的工具可以讓開發者的生活更加輕鬆。 Iron Suite 是一套強大的工具和程式庫，包括 IronPDF、IronXL、IronOCR 和 IronBarcode。讓我們探索這些工具，看看它們如何在不需要任何爭辯的情況下提升您的編程體驗。

IronPDF PDF處理變得簡單

了解IronPDF作為Iron Suite的重要組成部分。這是一個允許開發者在C#中建立、讀取和編輯PDF文件的程式庫。如果您想將HTML轉換為PDF，IronPDF擁有您所需的工具。查看將HTML轉換為PDF的教程，以了解更多有關此功能的資訊。

IronXL Excel操控觸手可及

在C#中處理Excel文件可能具有挑戰性，但IronXL功能簡化了這項任務。它允許您在不安裝Excel的情況下閱讀、寫入、編輯和操作Excel文件。從導入資料到建立新試算表，IronXL使在C#中處理Excel變得輕鬆。

IronOCR Optical Character Recognition for C#

光學字元識別（OCR）可能很複雜，但發現IronOCR以簡化過程。使用此程式庫，您可以從圖像中讀取文字並將其轉換為機器可讀的文字。無論您需要從掃描的文件中提取文字，還是從圖像中識別字元，IronOCR都具備能幫助的功能。

IronBarcode條碼生成和讀取

條碼被廣泛應用於各行各業，在您的應用程式中處理條碼現在通過IronBarcode程式庫變得更加容易。此程式庫讓您可以在C#中建立、讀取和處理條碼。 IronBarcode支持廣泛的QR和條碼格式。

Iron Suite與ref關鍵字的關係

您可能會想知道這些工具如何與我們討論的 ref 關鍵字相關。在涉及PDF、Excel、OCR或條碼的複雜項目中，為了有效地使用 ref 關鍵字及其他C#原則，這將是有效管理您的程式碼的關鍵。

例如，當使用IronXL處理大型Excel文件時，使用 ref 關鍵字按引用傳遞物件可以使程式碼更高效且易於維護。同樣，使用IronPDF處理PDF文件可能涉及到使用 ref 關鍵字的辦法。

了解類似 ref 關鍵字等核心語言功能，再加上Iron Suite工具，使您能夠組合出強大的對策以構建高效、堅固和多功能的應用程式。 Iron Suite設計為無縫整合進您的C#知識中，能幫助您建立更專業和複雜的解決方案。

結論

C#語言具有如 ref 關鍵字的功能，為開發人員提供了強大的能力。結合Iron Suite，包括 IronPDF、IronXL、IronOCR 和 IronBarcode，可能性變得更加廣泛。

Iron Suite 中的每個產品都提供免費試用，讓您能夠探索和運用其廣泛的功能，而無需立即投入資金。如果您決定選擇完整授權，個別組件的定價從 $999 開始。

如果您發現整個 Iron Suite 符合您的需求，則有一個優秀的交易在等著您。您可以以僅僅兩個單獨組件的價格購得整套套件。

Jacob Mellor

立即與工程團隊聊天

首席技術官

Jacob Mellor是Iron Software的首席技術官，一位在C# PDF技術上開創先河的遠見工程師。作為Iron Software核心程式碼庫的原開發者，他從創立以來就一直在塑造公司的產品架構，與首席執行官Cameron Rimington一起將公司轉變為服務於NASA、特斯拉和全球政府公司的50多名人員的公司。

...