ref值传递与引用传递

Ref

若要使用ref参数，方法定义和调用方法均必须显式使用ref关键字，如下面的示例所示。

C#

class RefExample

{

static void Method(ref int i)

{

// Rest the mouse pointer over i to verify that it is an int.

// The following statement would cause a compiler error if i

// were boxed as an object.

i = i + 44;

}

static void Main()

{

int val = 1;

Method(ref val);

Console.WriteLine(val);

// Output: 45

}

}

传递到ref形参的实参必须先经过初始化，然后才能传递。这与out形参不同，在传递之前，不需要显式初始化该形参的实参。有关详细信息，请参阅out。

类的成员不能具有仅在ref和out方面不同的签名。如果类型的两个成员之间的唯一区别在于其中一个具有ref参数，而另一个具有out参数，则会发生编译错误。例如，以下代码将不会编译。C#

class CS0663_Example

{

// Compiler error CS0663: "Cannot define overloaded

// methods that differ only on ref and out".

public void SampleMethod(out int i) { }

public void SampleMethod(ref int i) { }

}

但是，当一个方法具有ref或out参数，另一个方法具有值参数时，则可以完成重载，如下面的示例所示。

C#

class RefOverloadExample

{

public void SampleMethod(int i) { }

public void SampleMethod(ref int i) { }

}

在其他要求签名匹配的情况下（如隐藏或重写），ref和out是签名的一部分，相互之间不匹配。属性不是变量。它们是方法，不能传递到ref参数。

Ref与Out的区别

Out关键字

你可以在两个上下文（每个都是指向详细信息的链接）中使用 out 上下文关键字作为参数修饰符，或在接口和委托中使用泛型类型参数声明。本主题讨论参数修饰符，但你可以参阅其他主题了解关于泛型类型参数声明的信息。

out 关键字通过引用传递参数。这与ref关键字相似，只不过 ref 要求在传递之前初始化变量。若要使用 out 参数，方法定义和调用方法均必须显式使用 out 关键字。例如：

class OutExample

{

static void Method(out int i)

{

i = 44;

}

static void Main()

{

int value;

Method(out value);

// value is now 44

}

}

尽管作为 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(out int i) { }

public void SampleMethod(ref int i) { }

}

但是，如果一个方法采用 ref 或 out 参数，而另一个方法采用其他参数，则可以完成重载，如：

class OutOverloadExample

{

public void SampleMethod(int i) { }

public void SampleMethod(out int i) { i = 5; }

}

属性不是变量，因此不能作为 out 参数传递。

你不能将 ref 和 out 关键字用于以下几种方法：

?异步方法，通过使用async修饰符定义。

?迭代器方法，包括yield return或 yield break 语句。

如果希望方法返回多个值，可以声明 out 方法。下面的示例使用 out 返回具有单个方法调用的三个变量。注意，第三个参数赋 null 值。这使得方法可以有选择地返回值。

class OutReturnExample

{

static void Method(out int i, out string s1, out string s2)

{

i = 44;

s1 = "I've been returned";

s2 = null;

}

static void Main()

{

int value;

string str1, str2;

Method(out value, out str1, out str2);

// value is now 44

// str1 is now "I've been returned"

// str2 is (still) null;

}

}

Ref与Out传递数组

与所有out参数一样，在使用数组类型的out参数前必须先为其赋值；即必须由被调用方为其赋值。例如：

static void TestMethod1(out int[] arr)

{

arr = new int[10]; // definite assignment of arr

}

与所有ref参数一样，数组类型的ref参数必须由调用方明确赋值。因此，不需要由被调用方明确赋值。可以将数组类型的ref参数更改为调用的结果。例如，可以为数组赋以null值，或将其初始化为另一个数组。例如：

static void TestMethod2(ref int[] arr)

{

arr = new int[10]; // arr initialized to a different array

}

下面两个示例演示了out与ref在将数组传递给方法时的用法差异。

在此示例中，在调用方（Main方法）中声明数组theArray，并在FillArray方法中初始化此数组。然后，数组元素将返回调用方并显示。

class TestOut

{

static void FillArray(out int[] arr)

{

// Initialize the array:

arr = new int[5] { 1, 2, 3, 4, 5 };

}

static void Main()

{

int[] theArray; // Initialization is not required

// Pass the array to the callee using out:

FillArray(out theArray);

// Display the array elements:

System.Console.WriteLine("Array elements are:");

for (int i = 0; i < theArray.Length; i++)

{

System.Console.Write(theArray[i] + " ");

}

// Keep the console window open in debug mode.

System.Console.WriteLine("Press any key to exit.");

System.Console.ReadKey();

}

}

/* Output:

Array elements are:

1 2 3 4 5

*/

在此示例中，在调用方（Main方法）中初始化数组theArray，并通过使用ref参数将其传递

给FillArray方法。在FillArray方法中更新某些数组元素。然后，数组元素将返回调用方并显示。

class TestRef

{

static void FillArray(ref int[] arr)

{

// Create the array on demand:

if (arr == null)

{

arr = new int[10];

}

// Fill the array:

arr[0] = 1111;

arr[4] = 5555;

}

static void Main()

{

// Initialize the array:

int[] theArray = { 1, 2, 3, 4, 5 };

// Pass the array using ref:

FillArray(ref theArray);

// Display the updated array:

System.Console.WriteLine("Array elements are:");

for (int i = 0; i < theArray.Length; i++)

{

System.Console.Write(theArray[i] + " ");

}

// Keep the console window open in debug mode.

System.Console.WriteLine("Press any key to exit."); System.Console.ReadKey();

}

}

/* Output:

Array elements are:

1111 2 3 4 5555

*/