一句話概括:ByVal 傳值,ByRef 傳址。這個差異直接決定「在程序裡改了參數,外面那個變數會不會跟著變」,是 VB 新手最容易踩的坑。
ByVal(By Value):把實際參數的值複製一份傳進去。函式內部操作的是副本,原變數不受影響。
ByRef(By Reference):傳的是變數的記憶體位址。函式內部操作的就是原變數本身,改動會反映回呼叫端。
VB.NET 中參數預設是 ByVal,這點與舊版 VB6(預設 ByRef)相反,遷移舊專案時要特別留意。
C# 的 ref 等同 ByRef,out 則是「只出不進」的 ByRef。兩者規則略有差異:
1、ref 參數在傳入前必須已明確賦值;out 參數不要求事先賦值,但函式在正常返回前必須完成賦值。
2、在函式內部,ref 參數被視為「初始已賦值」,out 參數被視為「初始未賦值」。
3、當參數型別是參考型別(如物件、陣列、字串)時,即使使用 ByVal,你複製的也是「物件的參考」而非物件本身。因此透過該參數修改物件的屬性,外部仍然看得到變化——這是 ByVal 最容易被誤解的地方:不重新指派參考,物件內容一樣會被改到。
Sub Add1(ByVal no As Int32)
no = no + 100
End Sub
Sub Add2(ByRef no As Int32)
no = no + 100
End Sub
Private Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click
Dim a As Int32 = 100
Add1(a)
MessageBox.Show("a的值為:" & a) ' 顯示 100,副本被改,原值不動
Add2(a)
MessageBox.Show("a的值為:" & a) ' 顯示 200,傳址,原值被改
End Sub
預設用 ByVal,這讓函式行為可預測、易除錯。
只有兩種情況才考慮 ByRef:一是函式需要回傳多個結果(此時更推薦自訂型別或 Tuple);二是操作大型結構(Structure)想避免複製成本。
對參考型別而言,ByRef 與 ByVal 的差異只在「能否重新指向另一個物件」,而非「能否修改物件內容」,這一點釐清後,多數困惑自然消失。