C# 語言參考
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" }}