编辑“︁C Sharp 命名参数”︁

{{DISPLAYTITLE:C#命名参数}}

'''C#命名参数'''是C#语言中一种增强代码可读性和灵活性的特性，允许在调用方法时通过参数名称而非位置来指定参数值。本文详细介绍其语法、使用场景及最佳实践。

== 概述 ==
命名参数（Named Parameters）是C# 4.0引入的特性，它允许开发者通过显式指定参数名称来传递值，而无需严格依赖参数定义的顺序。这一特性特别适用于以下场景：
* 方法包含多个可选参数时
* 需要提高代码可读性时
* 避免因参数顺序变动导致的错误

=== 基本语法 ===
命名参数的语法格式为：
<syntaxhighlight lang="csharp">
MethodName(parameterName: value);
</syntaxhighlight>

== 基础示例 ==
以下示例展示命名参数的基本用法：
<syntaxhighlight lang="csharp">
// 定义方法
void PrintDetails(string name, int age, string country = "Unknown") 
{
    Console.WriteLine($"Name: {name}, Age: {age}, Country: {country}");
}

// 调用方法
PrintDetails(age: 25, name: "Alice"); // 输出：Name: Alice, Age: 25, Country: Unknown
</syntaxhighlight>

'''关键点说明：'''
* 参数顺序可以自由调整
* 未指定的可选参数（如`country`）使用默认值
* 参数名称必须与方法定义完全一致

== 命名参数与位置参数结合 ==
命名参数可与传统的位置参数混合使用，但需遵循规则：
* 所有位置参数必须出现在命名参数之前
* 不能对同一参数重复赋值

<syntaxhighlight lang="csharp">
PrintDetails("Bob", country: "Canada", age: 30); // 有效调用
// PrintDetails(name: "Bob", 30, "Canada");      // 编译错误：位置参数不能在命名参数后
</syntaxhighlight>

== 实际应用案例 ==
=== 场景1：提高API可读性 ===
在具有多个布尔参数的场景中，命名参数显著提升代码可读性：
<syntaxhighlight lang="csharp">
// 传统调用方式
ConnectToDatabase("server", true, false, true);

// 使用命名参数
ConnectToDatabase(
    serverName: "server", 
    useEncryption: true, 
    logConnection: false, 
    allowRetry: true);
</syntaxhighlight>

=== 场景2：与可选参数配合 ===
命名参数与可选参数结合使用时能创建高度灵活的API：
<syntaxhighlight lang="csharp">
public void Configure(
    string protocol = "https",
    int timeout = 30,
    bool caching = true,
    int retries = 3)
{
    // 配置逻辑
}

// 只需覆盖部分默认值
Configure(timeout: 60, retries: 5);
</syntaxhighlight>

== 高级主题 ==
=== 动态参数绑定 ===
通过反射动态调用方法时，命名参数可与`dynamic`类型结合使用：
<syntaxhighlight lang="csharp">
dynamic config = new ExpandoObject();
config.protocol = "ftp";
config.timeout = 20;

Configure(**config); // 需要C# 6.0+支持
</syntaxhighlight>

=== 性能考量 ===
命名参数在编译时会被转换为传统的位置参数，因此：
* 无运行时性能开销
* 不影响反射获取的参数信息
* 编译后的IL代码与位置参数等效

== 最佳实践 ==
* '''优先用于多参数方法'''：当方法参数超过3个时建议使用
* '''避免过度使用'''：简单方法保持位置参数更简洁
* '''保持一致性'''：团队内部统一命名风格（如全小写或驼峰式）
* '''文档标注'''：对复杂API建议在注释中说明推荐参数组合

== 常见问题 ==
=== Q1: 命名参数能否用于委托？ ===
可以，委托调用同样支持命名参数语法：
<syntaxhighlight lang="csharp">
Action<string, int> handler = PrintDetails;
handler(age: 30, name: "Charlie");
</syntaxhighlight>

=== Q2: 如何强制使用命名参数？ ===
可通过[CallerArgumentExpression]特性（C# 10+）实现：
<syntaxhighlight lang="csharp">
void Log([CallerArgumentExpression("value")] string expr = null, object value = null)
{
    Console.WriteLine($"{expr} = {value}");
}

Log(value: 42); // 输出："42 = 42"
</syntaxhighlight>

== 可视化参数传递 ==
以下Mermaid图展示命名参数的解析过程：
<mermaid>
sequenceDiagram
    participant Caller
    participant Compiler
    participant Method
    
    Caller->>Compiler: PrintDetails(age:25, name:"Alice")
    Compiler->>Method: 重排为PrintDetails("Alice", 25, "Unknown")
    Method-->>Caller: 执行结果
</mermaid>

== 数学表示 ==
从形式化角度看，命名参数实现了从无序集合到有序集合的映射。设方法有<math>n</math>个参数，其位置集合为<math>P = \{1,2,...,n\}</math>，名称集合为<math>N = \{name_1,...,name_n\}</math>，则调用时建立的映射为：
<math>
f: N \times V \rightarrow P \times V
</math>
其中<math>V</math>为参数值域。

== 总结 ==
C#命名参数是提升代码可维护性的重要工具，特别适合：
* 包含多个同类型参数的方法
* 频繁变更参数顺序的API
* 需要明确参数意图的公共接口

通过合理使用此特性，可以显著降低代码维护成本并减少参数传递错误。

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