C# Ref Keywords (How it Works for Developers)

參考關鍵字簡介

在 C# 中傳遞方法參數時，預設是按值傳遞的。 這意味著會建立參數值的副本，並且在被呼叫方法內所做的任何更改都不會影響方法外部的原始變數。 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
    }
}

在上面的程式碼中，即使我們在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
    }
}

注意方法簽名和呼叫中都出現了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
    }
}

在這個範例中， 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
    }
}

在上面的範例中，我們重載了Add方法，使其能夠同時處理int和double型別。 ref 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
    }
}

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

潛在陷阱

雖然ref和out關鍵字是強大的工具，但應該謹慎使用。 錯誤使用這些關鍵字會導致程式碼混亂和出現意想不到的行為。 例如，你不能在未先初始化的情況下，在ref或out參數中使用非引用變量，因為這會導致編譯錯誤。

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;
    }
}

隆重推出 Iron Suite

除了理解 C# 中的ref關鍵字等關鍵概念之外，還有一系列強大的工具可以大大簡化開發人員的工作。 Iron Suite 是一套強大的工具和庫，其中包括 IronPDF、IronXL、IronOCR 和 IronBarcode。 讓我們一起來探索這些工具，看看它們如何毫無爭議地提升您的程式設計體驗。

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 中的每款產品都提供免費試用，讓您無需立即投資即可探索和使用其豐富的功能。 如果您決定購買完整許可證，單一組件的起價為$799 。

如果您覺得整個鐵套房都符合您的需求，那麼有一個非常優惠的價格等著您。 您只需支付兩個單獨組件的價格，即可獲得整套產品。