Optional and named parameters特性在有些场合提供很大的方便,特别是Office开发中可以告别一坨System.Reflection.Missing了。这里简单了解一下C#4.0中的Optional and named parameters。
在VS2010 CTP中的C#4.0编译器调试通过,正式版可能会有些变化。
1.使用示例
运行结果为:

使用中的注意事项:
当必选参数与可选参数在同一个方法中混合使用时,必选参数的声明应该放在可选参数的前面。
可选参数的初始值必须是一个在编译期可确定的常量。
可选参数不可用ref,out等修饰符。
如果全部显式指定参数名(paraName:value),参数的顺序可以任意调整。
2.内部实现
ILDASM反编译一下Test.OptionalAndNamedParams,代码段为:
可选参数前声明为OptionalAttribute特性。这是C#4.0的语法糖。
Test.OptionalAndNamedParams方法等价的代码为:
如果不用DefaultParameterValueAttribute特性设置默认值,则输出为:

现在知道了Office开发中Missing的原因了。
OptionalAttribute和DefaultParameterValueAttribute不是FCL的新类,他们把方法的参数声明为可选方法和指定默认值,以便被支持可选参数和默认参数的语言调用(如VB、VC++等)。
3.调用过程
Main方法中,调用t.OptionalAndNamedParams(1)的IL代码为(Release模式编译):
可以看到,编译器先取得可选参数的默认值,然后像常规方法一样调用,并不是后期邦定,这在程序集版本控制时应加以注意,更新了应用程序中含有可选参数方法的程序集后,可能由于默认值的改变导致程序行为异常。
4.方法重载
可选参数与方法重载时,方法的调用方式一模一样,到底调用的哪个可以举个例子:
在上面的Test类添加一个方法,定义为:
输出结果变成:

可以看出,首先调用参数完全匹配的方法。
参考资料:
MSDN
Named arguments, optional arguments, and default values
在VS2010 CTP中的C#4.0编译器调试通过,正式版可能会有些变化。
1.使用示例
class Program
{
static void Main(string[] args)
{
Test t = new Test();
t.OptionalAndNamedParams(1);
t.OptionalAndNamedParams(2, "a");
t.OptionalAndNamedParams(3, c: "b", b: "a");
t.OptionalAndNamedParams(4, c: "http://g.cn");
}
}
class Test
{
// a为必选参数;b,c为可选参数
public void OptionalAndNamedParams(int a, string b = "", object c = "http://xianfen.net")
{
Console.WriteLine("a:{0}, b:{1}, c:{2}", a, b, c);
}
}
{
static void Main(string[] args)
{
Test t = new Test();
t.OptionalAndNamedParams(1);
t.OptionalAndNamedParams(2, "a");
t.OptionalAndNamedParams(3, c: "b", b: "a");
t.OptionalAndNamedParams(4, c: "http://g.cn");
}
}
class Test
{
// a为必选参数;b,c为可选参数
public void OptionalAndNamedParams(int a, string b = "", object c = "http://xianfen.net")
{
Console.WriteLine("a:{0}, b:{1}, c:{2}", a, b, c);
}
}
运行结果为:

使用中的注意事项:
当必选参数与可选参数在同一个方法中混合使用时,必选参数的声明应该放在可选参数的前面。
可选参数的初始值必须是一个在编译期可确定的常量。
可选参数不可用ref,out等修饰符。
如果全部显式指定参数名(paraName:value),参数的顺序可以任意调整。
2.内部实现
ILDASM反编译一下Test.OptionalAndNamedParams,代码段为:
.method public hidebysig instance void OptionalAndNamedParams(int32 a,
[opt] string b,
[opt] object c) cil managed
{
.param [2] = ""
.param [3] = "http://www.xianfen.net"
// ...
[opt] string b,
[opt] object c) cil managed
{
.param [2] = ""
.param [3] = "http://www.xianfen.net"
// ...
可选参数前声明为OptionalAttribute特性。这是C#4.0的语法糖。
Test.OptionalAndNamedParams方法等价的代码为:
public void OptionalAndNamedParams(int a,
[Optional, DefaultParameterValue("")] string b,
[Optional, DefaultParameterValue("http://www.xianfen.net")] object c)
{
Console.WriteLine("a:{0}, b:{1}, c:{2}", a, b, c);
}
[Optional, DefaultParameterValue("")] string b,
[Optional, DefaultParameterValue("http://www.xianfen.net")] object c)
{
Console.WriteLine("a:{0}, b:{1}, c:{2}", a, b, c);
}
如果不用DefaultParameterValueAttribute特性设置默认值,则输出为:

现在知道了Office开发中Missing的原因了。
OptionalAttribute和DefaultParameterValueAttribute不是FCL的新类,他们把方法的参数声明为可选方法和指定默认值,以便被支持可选参数和默认参数的语言调用(如VB、VC++等)。
3.调用过程
Main方法中,调用t.OptionalAndNamedParams(1)的IL代码为(Release模式编译):
IL_0006: ldloc.0
IL_0007: ldc.i4.1
IL_0008: ldstr ""
IL_000d: ldstr "http://www.xianfen.net"
IL_0012: callvirt instance void Test::OptionalAndNamedParams(int32,
string,
object)
IL_0007: ldc.i4.1
IL_0008: ldstr ""
IL_000d: ldstr "http://www.xianfen.net"
IL_0012: callvirt instance void Test::OptionalAndNamedParams(int32,
string,
object)
可以看到,编译器先取得可选参数的默认值,然后像常规方法一样调用,并不是后期邦定,这在程序集版本控制时应加以注意,更新了应用程序中含有可选参数方法的程序集后,可能由于默认值的改变导致程序行为异常。
4.方法重载
可选参数与方法重载时,方法的调用方式一模一样,到底调用的哪个可以举个例子:
在上面的Test类添加一个方法,定义为:
public void OptionalAndNamedParams(int a, string b)
{
Console.WriteLine("overload, a:{0}, b:{1}", a, b);
}
{
Console.WriteLine("overload, a:{0}, b:{1}", a, b);
}
输出结果变成:

可以看出,首先调用参数完全匹配的方法。
参考资料:
MSDN
Named arguments, optional arguments, and default values
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 如何编写易于单元测试的代码
· 10年+ .NET Coder 心语,封装的思维:从隐藏、稳定开始理解其本质意义
· .NET Core 中如何实现缓存的预热?
· 从 HTTP 原因短语缺失研究 HTTP/2 和 HTTP/3 的设计差异
· AI与.NET技术实操系列:向量存储与相似性搜索在 .NET 中的实现
· 周边上新:园子的第一款马克杯温暖上架
· Open-Sora 2.0 重磅开源!
· 分享 3 个 .NET 开源的文件压缩处理库,助力快速实现文件压缩解压功能!
· Ollama——大语言模型本地部署的极速利器
· DeepSeek如何颠覆传统软件测试?测试工程师会被淘汰吗?