VS2008 .NET 3.5项目中调用QRCoder带默认参数的CreateQrCode方法报错的原因

核心结论 #

VS2008内置的C# 3.0编译器无法识别高版本C#编译出来的可选参数（带默认值的方法参数）元数据，这是报错的根本原因，和.NET 3.5运行时本身没有直接关联。

详细解释 #

• 可选参数是C# 4.0 才正式引入的语言特性，首次随Visual Studio 2010发布。VS2008的内置编译器最高仅支持C# 3.0语法，完全不识别可选参数对应的元数据标记。
• 你用VS2019编译QRCoder时，源码里的CreateQrCode方法附带的默认参数，会被高版本编译器写入[Optional]、[DefaultParameterValue]这类自定义特性，用来告知调用侧的编译器“后续参数可以省略，自动填充预设的默认值”。
• 当VS2008的C#3.0编译器引用这个编译好的dll时，根本读不懂上述元数据标记，只会把该方法的全部6个参数当成必须传入的固定参数，默认不存在“可以省略后4个参数”的规则。
• 因此你只传入2个参数时，编译器判定参数数量不匹配，自然抛出“找不到匹配的方法重载”的报错。

澄清误区：这个问题和dll的目标框架选.NET 3.5没有关系，哪怕dll的编译目标设为.NET 2.0，只要是用高版本C#编译器编写了带可选参数的方法，VS2008的老编译器引用时都会出现同样的问题。

关于你当前的解决方案 #

你在QRCoder源码里显式新增双参数重载方法的做法是完全合理的：这类重载是C#从1.0版本就支持的标准方法定义，没有依赖可选参数这类语法糖，所有版本的编译器都能正常识别匹配，重新编译后报错消失是符合预期的。

内容的提问来源于stack exchange，提问作者user15759356