编辑“︁C Sharp 参数传递”︁（章节）

= C#参数传递 =

参数传递是C#编程中的核心概念之一，它决定了如何将数据传递给方法（函数）。理解不同的参数传递方式对于编写高效、可维护的代码至关重要。本章将详细介绍C#中的参数传递机制，包括值传递、引用传递、输出参数、参数数组等，并提供实际案例帮助理解。

== 参数传递的基本概念 ==

在C#中，参数传递主要有以下几种方式：
* '''值传递（Pass by Value）'''：传递参数的副本，方法内对参数的修改不会影响原始值。
* '''引用传递（Pass by Reference）'''：传递参数的内存地址，方法内对参数的修改会影响原始值。
* '''输出参数（Out Parameters）'''：用于从方法返回多个值，必须在方法内赋值。
* '''参数数组（Params）'''：允许方法接受可变数量的参数。

== 值传递 ==

值传递是C#的默认参数传递方式。当使用值传递时，方法接收的是参数的副本，而不是原始变量本身。

<syntaxhighlight lang="csharp">
using System;

class Program
{
    static void ModifyValue(int x)
    {
        x = x * 2;
        Console.WriteLine("方法内修改后的值: " + x);
    }

    static void Main()
    {
        int num = 5;
        Console.WriteLine("调用方法前的值: " + num);
        ModifyValue(num);
        Console.WriteLine("调用方法后的值: " + num);
    }
}
</syntaxhighlight>

输出：
<pre>
调用方法前的值: 5
方法内修改后的值: 10
调用方法后的值: 5
</pre>

解释：虽然方法内修改了x的值，但原始变量num保持不变，因为传递的是值的副本。

== 引用传递 ==

使用'''ref'''关键字可以实现引用传递，这样方法接收的是原始变量的引用，而不是副本。

<syntaxhighlight lang="csharp">
using System;

class Program
{
    static void ModifyValue(ref int x)
    {
        x = x * 2;
        Console.WriteLine("方法内修改后的值: " + x);
    }

    static void Main()
    {
        int num = 5;
        Console.WriteLine("调用方法前的值: " + num);
        ModifyValue(ref num);
        Console.WriteLine("调用方法后的值: " + num);
    }
}
</syntaxhighlight>

输出：
<pre>
调用方法前的值: 5
方法内修改后的值: 10
调用方法后的值: 10
</pre>

解释：使用ref关键字后，方法内对参数的修改会影响原始变量。

== 输出参数 ==

'''out'''关键字用于输出参数，它类似于ref参数，但不需要在传递前初始化变量。

<syntaxhighlight lang="csharp">
using System;

class Program
{
    static void Calculate(int x, int y, out int sum, out int product)
    {
        sum = x + y;
        product = x * y;
    }

    static void Main()
    {
        int a = 3, b = 4;
        int s, p;
        Calculate(a, b, out s, out p);
        Console.WriteLine($"和: {s}, 积: {p}");
    }
}
</syntaxhighlight>

输出：
<pre>
和: 7, 积: 12
</pre>

解释：out参数允许方法返回多个值，且调用方不需要预先初始化这些变量。

== 参数数组 ==

'''params'''关键字允许方法接受可变数量的参数，这些参数会被当作数组处理。

<syntaxhighlight lang="csharp">
using System;

class Program
{
    static int Sum(params int[] numbers)
    {
        int total = 0;
        foreach (int num in numbers)
        {
            total += num;
        }
        return total;
    }

    static void Main()
    {
        Console.WriteLine(Sum(1, 2, 3));
        Console.WriteLine(Sum(4, 5, 6, 7, 8));
    }
}
</syntaxhighlight>

输出：
<pre>
6
30
</pre>

解释：params关键字使方法能够接受任意数量的int参数，并将它们作为数组处理。

== 可选参数和命名参数 ==

C#还支持可选参数和命名参数，这增加了方法的灵活性。

<syntaxhighlight lang="csharp">
using System;

class Program
{
    static void PrintInfo(string name, int age = 30, string country = "Unknown")
    {
        Console.WriteLine($"Name: {name}, Age: {age}, Country: {country}");
    }

    static void Main()
    {
        PrintInfo("Alice");  // 使用默认值
        PrintInfo("Bob", 25);  // 覆盖age默认值
        PrintInfo("Charlie", country: "Canada");  // 使用命名参数
    }
}
</syntaxhighlight>

输出：
<pre>
Name: Alice, Age: 30, Country: Unknown
Name: Bob, Age: 25, Country: Unknown
Name: Charlie, Age: 30, Country: Canada
</pre>

== 参数传递的底层机制 ==

理解参数传递的底层机制有助于更好地掌握C#编程。以下是不同类型参数传递的内存示意图：

<mermaid>
graph LR
    A[调用方变量] -->|值传递| B[方法参数副本]
    A -->|ref/out传递| C[方法参数引用]
</mermaid>

对于值类型：
* 值传递：创建副本
* 引用传递：传递原始变量的地址

对于引用类型：
* 值传递：传递引用的副本（对象本身不会被复制）
* 引用传递：传递引用的引用

== 实际应用案例 ==

'''案例1：交换两个变量的值'''

<syntaxhighlight lang="csharp">
using System;

class Program
{
    static void Swap(ref int a, ref int b)
    {
        int temp = a;
        a = b;
        b = temp;
    }

    static void Main()
    {
        int x = 10, y = 20;
        Console.WriteLine($"交换前: x={x}, y={y}");
        Swap(ref x, ref y);
        Console.WriteLine($"交换后: x={x}, y={y}");
    }
}
</syntaxhighlight>

'''案例2：从方法返回多个值'''

<syntaxhighlight lang="csharp">
using System;

class Geometry
{
    public static void CalculateCircle(double radius, out double area, out double circumference)
    {
        area = Math.PI * radius * radius;
        circumference = 2 * Math.PI * radius;
    }
}

class Program
{
    static void Main()
    {
        double r = 5;
        double a, c;
        Geometry.CalculateCircle(r, out a, out c);
        Console.WriteLine($"半径 {r} 的圆: 面积={a:F2}, 周长={c:F2}");
    }
}
</syntaxhighlight>

== 性能考虑 ==

选择参数传递方式时需要考虑性能影响：
* 对于大型结构体，值传递会产生复制开销，应考虑使用ref
* 频繁的方法调用中，参数传递方式会影响性能
* out参数比返回元组在某些情况下更高效

== 最佳实践 ==

1. 优先使用值传递，除非确实需要修改原始变量
2. 对于需要返回多个值的情况，考虑使用out参数或元组
3. 避免过度使用ref，因为它会降低代码的可读性
4. 对于大型结构体，使用ref传递以提高性能
5. 使用params关键字使API更灵活

== 常见问题 ==

'''Q: ref和out有什么区别？'''
A: ref参数必须在传递前初始化，而out参数必须在方法内赋值。

'''Q: 什么时候应该使用params？'''
A: 当方法需要接受可变数量的同类型参数时使用params。

'''Q: 值传递会影响引用类型吗？'''
A: 对于引用类型，值传递的是引用的副本，所以可以修改对象的状态，但不能替换整个对象。

通过本章的学习，你应该已经掌握了C#中各种参数传递方式的区别和使用场景。理解这些概念对于编写高效、可维护的C#代码至关重要。

[[Category:编程语言]]
[[Category:C Sharp]]
[[Category:C Sharp 函数]]