C#4.0新增功能02 命名实参和可选实参

时间 2019-11-17

标签 c#4.0 新增功能命名可选栏目 C# 繁體版

原文原文链接

系列目录【已更新最新开发文章，点击查看详细】

　　C# 4 介绍命名实参和可选实参。经过命名实参，你能够为特定形参指定实参，方法是将实参与该形参的名称关联，而不是与形参在形参列表中的位置关联。经过可选参数，你能够为某些形参省略实参。这两种技术均可与方法、索引器、构造函数和委托一块儿使用。html

使用命名参数和可选参数时，将按实参出如今实参列表（而不是形参列表）中的顺序计算这些实参。express

命名形参和可选形参一块儿使用时，你能够只为可选形参列表中的少数形参提供实参。此功能极大地方便了对 COM 接口（例如 Microsoft Office 自动化 API）的调用。编程

命名实参

　　有了命名实参，你将再也不须要记住或查找形参在所调用方法的形参列表中的顺序。每一个实参的形参均可按形参名称进行指定。例如，经过以函数定义的顺序按位置发送实参，能够采用标准方式调用打印订单详细信息（例如卖家姓名、订单号和产品名称）的函数。api

PrintOrderDetails("Gift Shop", 31, "Red Mug");ide

若是不记得形参的顺序，但却知道其名称，则能够按任意顺序发送实参。函数

PrintOrderDetails(orderNum: 31, productName: "Red Mug", sellerName: "Gift Shop");ui

PrintOrderDetails(productName: "Red Mug", sellerName: "Gift Shop", orderNum: 31);spa

命名实参还能够标识每一个实参所表示的含义，从而改进代码的可读性。在下面的示例方法中，sellerName 不得为 NULL 或空白符。因为 sellerName 和 productName 都是字符串类型，因此使用命名实参而不是按位置发送实参是有意义的，能够区分这两种类型并减小代码阅读者的困惑。excel

当命名实参与位置实参一块儿使用时，只要code

没有后接任何位置实参或

PrintOrderDetails("Gift Shop", 31, productName: "Red Mug");

以 C# 7.2 开头，则它们就有效并用在正确位置。在如下示例中，形参 orderNum 位于正确的位置，但未显式命名。

PrintOrderDetails(sellerName: "Gift Shop", 31, productName: "Red Mug");

可是，若是其后接位置实参，则无序命名实参无效。

// 出现 CS1738 警告: 命名参数规范必须出如今指定了全部固定参数以后。
PrintOrderDetails(productName: "Red Mug", 31, "Gift Shop");

示例

如下代码执行本节以及某些其余节中的示例。

class NamedExample
{
    static void Main(string[] args)
    {
        // 使用位置参数以常规方式调用方法。
        PrintOrderDetails("Gift Shop", 31, "Red Mug");

        // 能够按任意顺序为参数提供命名参数。
        PrintOrderDetails(orderNum: 31, productName: "Red Mug", sellerName: "Gift Shop");
        PrintOrderDetails(productName: "Red Mug", sellerName: "Gift Shop", orderNum: 31);

        // 与位置参数混合的命名参数只要在正确的位置使用就有效
        PrintOrderDetails("Gift Shop", 31, productName: "Red Mug");
        PrintOrderDetails(sellerName: "Gift Shop", 31, productName: "Red Mug");    // C# 7.2 onwards
        PrintOrderDetails("Gift Shop", orderNum: 31, "Red Mug");                   // C# 7.2 onwards

        // 可是，若是使用顺序不对，则混合参数无效。
        // 下列声明会引发编译错误
        // PrintOrderDetails(productName: "Red Mug", 31, "Gift Shop");
        // PrintOrderDetails(31, sellerName: "Gift Shop", "Red Mug");
        // PrintOrderDetails(31, "Red Mug", sellerName: "Gift Shop");
    }

    static void PrintOrderDetails(string sellerName, int orderNum, string productName)
    {
        if (string.IsNullOrWhiteSpace(sellerName))
        {
            throw new ArgumentException(message: "Seller name cannot be null or empty.", paramName: nameof(sellerName));
        }

        Console.WriteLine($"Seller: {sellerName}, Order #: {orderNum}, Product: {productName}");
    }
}

可选实参

方法、构造函数、索引器或委托的定义能够指定其形参为必需仍是可选。任何调用都必须为全部必需的形参提供实参，但能够为可选的形参省略实参。

每一个可选形参都有一个默认值做为其定义的一部分。若是没有为该形参发送实参，则使用默认值。默认值必须是如下类型的表达式之一：

常量表达式；
new ValType() 形式的表达式，其中 ValType 是值类型，例如 enum 或 struct；
default(ValType) 形式的表达式，其中 ValType 是值类型。

可选参数定义于参数列表的末尾和必需参数以后。若是调用方为一系列可选形参中的任意一个形参提供了实参，则它必须为前面的全部可选形参提供实参。实参列表中不支持使用逗号分隔的间隔。例如，在如下代码中，使用一个必选形参和两个可选形参定义实例方法 ExampleMethod。

public void ExampleMethod(int required, string optionalstr = "default string",int optionalint = 10)

下面对 ExampleMethod 的调用会致使编译器错误，缘由是为第三个形参而不是为第二个形参提供了实参。

//anExample.ExampleMethod(3, ,4);

可是，若是知道第三个形参的名称，则能够使用命名实参来完成此任务。

anExample.ExampleMethod(3, optionalint: 4);

IntelliSense 使用括号表示可选形参，以下图所示：

还可经过使用 .NET OptionalAttribute 类声明可选参数。 OptionalAttribute 形参不须要默认值。

在如下示例中，ExampleClass 的构造函数具备一个可选形参。实例方法 ExampleMethod 具备一个必选形参（required）和两个可选形参（optionalstr 和 optionalint）。 Main 中的代码演示了可用于调用构造函数和方法的不一样方式。

 1 namespace OptionalNamespace
 2 {
 3     class OptionalExample
 4     {
 5         static void Main(string[] args)
 6         {
 7             // 实例 anexample 不发送构造函数可选参数的参数。
 8             ExampleClass anExample = new ExampleClass();
 9             anExample.ExampleMethod(1, "One", 1);
10             anExample.ExampleMethod(2, "Two");
11             anExample.ExampleMethod(3);
12 
13             // 实例anoThereExample为构造函数的可选参数发送参数。
14             ExampleClass anotherExample = new ExampleClass("Provided name");
15             anotherExample.ExampleMethod(1, "One", 1);
16             anotherExample.ExampleMethod(2, "Two");
17             anotherExample.ExampleMethod(3);
18 
19             // 如下语句产生编译器错误。
20 
21             // 必须为第一个参数提供参数，而且该参数必须是整数。
22             //anExample.ExampleMethod("One", 1);
23             //anExample.ExampleMethod();
24 
25             // 您不能在提供的参数中留下空白。
26             //anExample.ExampleMethod(3, ,4);
27             //anExample.ExampleMethod(3, 4);
28 
29             // 能够使用命名参数使前一条语句工做。
30             anExample.ExampleMethod(3, optionalint: 4);
31         }
32     }
33 
34     class ExampleClass
35     {
36         private string _name;
37 
38         // 由于构造函数name的参数有一个指定给它的默认值，因此是可选的
39         public ExampleClass(string name = "Default name")
40         {
41             _name = name;
42         }
43 
44         // 第一个参数（必需）没有指定默认值。所以，它不是可选的。OptionalStr和OptionalInt都有分配给它们的默认值。它们是可选的。
45         public void ExampleMethod(int required, string optionalstr = "default string",
46             int optionalint = 10)
47         {
48             Console.WriteLine("{0}: {1}, {2}, and {3}.", _name, required, optionalstr,
49                 optionalint);
50         }
51     }
52 
53     // 输出：
54     // Default name: 1, One, and 1.
55     // Default name: 2, Two, and 10.
56     // Default name: 3, default string, and 10.
57     // Provided name: 1, One, and 1.
58     // Provided name: 2, Two, and 10.
59     // Provided name: 3, default string, and 10.
60     // Default name: 3, default string, and 4.
61 
62 }

COM 接口

命名实参和可选实参，以及对动态对象的支持和其余加强功能大大提升了与 COM API（例如 Office Automation API）的互操做性。

例如，Microsoft Office Excel 的 Range 接口中的 AutoFormat 方法有七个可选形参。这些形参以下图所示：

在 C# 3.0 以及早期版本中，每一个形参都须要一个实参，以下例所示。

var excelApp = new Microsoft.Office.Interop.Excel.Application();
excelApp.Workbooks.Add();
excelApp.Visible = true;

var myFormat = Microsoft.Office.Interop.Excel.XlRangeAutoFormat.xlRangeAutoFormatAccounting1;
excelApp.get_Range("A1", "B4").AutoFormat(myFormat, Type.Missing, Type.Missing, Type.Missing, Type.Missing, Type.Missing, Type.Missing);

可是，能够经过使用 C# 4.0 中引入的命名实参和可选实参来大大简化对 AutoFormat 的调用。若是不但愿更改形参的默认值，则能够经过使用命名实参和可选实参来为可选形参省略实参。在下面的调用中，仅为 7 个形参中的其中一个指定了值。

excelApp.Range["A1", "B4"].AutoFormat( Format: myFormat );

有关详细信息和示例，请参阅操做说明：在 Office 编程中使用命名参数和可选参数和操做说明：使用 Visual C# 功能访问 Office 互操做对象。

重载决策

使用命名实参和可选实参将在如下方面对重载决策产生影响：

若是方法、索引器或构造函数的每一个参数是可选的，或按名称或位置对应于调用语句中的单个自变量，且该自变量可转换为参数的类型，则方法、索引器或构造函数为执行的候选项。
若是找到多个候选项，则会将用于首选转换的重载决策规则应用于显式指定的自变量。将忽略可选形参已省略的实参。
若是两个候选项不相上下，则会将没有可选形参的候选项做为首选项，对于这些可选形参，已在调用中为其省略了实参。这是重载决策中的常规引用的结果，该引用用于参数较少的候选项。

系列目录【已更新最新开发文章，点击查看详细】