ref（C# 參考）

標籤：

ref 關鍵字使參數按引用傳遞。其效果是，當控制權傳遞迴調用方法時，在方法中對參數所做的任何更改都將反映在該變數中。若要使用 ref 參數，則方法定義和調用方法都必須顯式使用 ref 關鍵字。例如：

  

class RefExample{    static void Method(ref int i)    {        i = 44;    }    static void Main()    {        int val = 0;        Method(ref val);        // val is now 44    }}

傳遞到 ref 參數的參數必須最先初始化。這與 out 不同，out 的參數在傳遞之前不需要顯式初始化。（請參見 out。）

儘管 ref 和 out 在運行時的處理方式不同，但它們在編譯時間的處理方式是相同的。因此，如果一個方法採用 ref 參數，而另一個方法採用 out 參數，則無法重載這兩個方法。例如，從編譯的角度來看，以下代碼中的兩個方法是完全相同的，因此將不會編譯以下代碼：

  

class CS0663_Example {    // compiler error CS0663: "cannot define overloaded     // methods that differ only on ref and out"    public void SampleMethod(ref int i) {  }    public void SampleMethod(out int i) {  }}

但是，如果一個方法採用 ref 或 out 參數，而另一個方法不採用這兩類參數，則可以進行重載，如下所示：

  

class RefOutOverloadExample{    public void SampleMethod(int i) {  }    public void SampleMethod(ref int i) {  }}

備忘 

屬性不是變數，因此不能作為 ref 參數傳遞。

有關傳遞數組的資訊，請參見使用 ref 和 out 傳遞數組。

樣本 

按引用傳遞實值型別（如上所示）是有用的，但是 ref 對於傳遞參考型別也是很有用的。這允許被調用的方法修改該引用所引用的對象，因為引用本身是按引用來傳遞的。下面的樣本顯示出當參考型別作為 ref 參數傳遞時，可以更改對象本身。

  

class RefRefExample{    static void Method(ref string s)    {        s = "changed";    }    static void Main()    {        string str = "original";        Method(ref str);        // str is now "changed"    }}

ref（C# 參考）