如何在C#中使用可选参数?


492

注意:在C#还不支持可选参数的时候(即在C#4之前)问这个问题。

我们正在构建从C#类以编程方式生成的Web API。该类具有方法GetFooBar(int a, int b),而API具有采用GetFooBar诸如的查询参数的方法&a=foo &b=bar

这些类需要支持可选参数,C#语言不支持该参数。最好的方法是什么?


7
或等待unitil C#4.0发布。支持可选参数。
米卡

Answers:


1053

没有人感到惊讶的是,C#4.0可选参数的工作方式如下:

public void SomeMethod(int a, int b = 0)
{
   //some code
}

编辑:我知道在提出问题时,C#4.0不存在。但是这个问题在“ C#可选参数”中仍然在Google中排名第一,所以我想-这个答案值得在这里。抱歉。


58
在提出问题时,C#4.0不存在。
福雷斯特·马维兹(Ferest Marvez)2010年

91
是的,忽略了这一点,对不起。但是这个问题在“ C#可选参数”中仍然在Google中排名第一,所以无论如何-这个答案值得在这里:)
Alex

45
您很高兴提供最新信息。理想情况下,原始答案将使用当前信息(例如C#4.0)进行更新。我相信这就是SO家伙最初的想法,就是Wiki的心态,但是每个人都有点太害怕编辑他人的答案。
罗文

我在WebServices中发现的有趣之处在于(默认情况下,在我测试的项目中)查询字符串中的所有布尔值都是可选的。显然,它们默认为FALSE。
卡洛斯·P

4
值得注意的是,必须在所有非可选参数之后放置可选参数。即您不能有公共无效SomeMethod(int b = 0,int a)
Andrew Meservy

129

另一种选择是使用params关键字

public void DoSomething(params object[] theObjects)
{
  foreach(object o in theObjects)
  {
    // Something with the Objects…
  }
}

叫做...

DoSomething(this, that, theOther);

57
此答案在10行中解释了params关键字
beautifilly

1
谢谢!这启发了我编写一个简单的(对于我当前的用例而言)日志记录功能:public void log (params object[] args){ StringBuilder sb = new StringBuilder(); for (int i = 0; i < args.Length; i++){ sb.Append("{"); sb.Append(i.ToString()); sb.Append("}"); sb.Append(" "); } String.Format(sb.ToString(),args).Dump(); }示例调用:log("...Done,",(watch.ElapsedMilliseconds/1000).ToString(),"s");
pfonseca 2015年

您能说一下,net 3.5是否支持它?官方文档没有提到。
T.Todua

@ T.Todua-我不确定100%是否在这里问-dotnet framework 3.5包含了C#v3.0-3.0版确实支持params关键字,但是没有可选参数,这是C#v4.0中引入的,它已包含在dotnet framework 4.0中
Tim Jarvis

@TimJarvis是的,那是我要的。tnx
T.Todua

77

在C#中,我通常会使用多种形式的方法:

void GetFooBar(int a) { int defaultBValue;  GetFooBar(a, defaultBValue); }
void GetFooBar(int a, int b)
{
 // whatever here
}

更新: 以上是我使用C#2.0进行默认值的方式。我现在正在处理的项目正在使用C#4.0,该版本现在直接支持可选参数。这是我刚刚在自己的代码中使用的示例:

public EDIDocument ApplyEDIEnvelop(EDIVanInfo sender, 
                                   EDIVanInfo receiver, 
                                   EDIDocumentInfo info,
                                   EDIDocumentType type 
                                     = new EDIDocumentType(EDIDocTypes.X12_814),
                                   bool Production = false)
{
   // My code is here
}

1
我相信您不能在默认参数中调用构造函数,它们需要“编译时”兼容,而不是“运行时” ...还是我错了?
亚历克斯(Alex)2013年

45

从此站点:

http://www.tek-tips.com/viewthread.cfm?qid=1500861&page=1

C#确实允许使用[Optional]属性(来自VB,尽管在C#中不起作用)。因此,您可以使用以下方法:

using System.Runtime.InteropServices;
public void Foo(int a, int b, [Optional] int c)
{
  ...
}

在我们的API包装器中,我们检测可选参数(ParameterInfo p.IsOptional)并设置默认值。目的是将参数标记为可选,而不必像在参数名称中使用“可选”那样费力。


4
但是如何使用Foo函数呢?Foo(1,1); foo(1,1,null)和foo(1,1,Missing.value)都将引发异常
Bolu

2
奇怪,上面的一些答案比这要好得多。
Maidot

26

您可以使用方法重载...

GetFooBar()
GetFooBar(int一个)
GetFooBar(int a,int b)

它取决于方法签名,我给出的示例缺少“ int b”方法,因为它与“ int a”方法具有相同的签名。

您可以使用Nullable类型...

GetFooBar(int?a,int?b)

然后,您可以使用a.HasValue检查是否已设置参数。

另一种选择是使用“参数”参数。

GetFooBar(参数对象[]参数)

如果您想使用命名参数,则需要创建一个类型来处理它们,尽管我认为Web应用程序已经存在类似的东西。


24

您可以在C#4.0中使用可选参数,而无需担心。如果我们有这样的方法:

int MyMetod(int param1, int param2, int param3=10, int param4=20){....}

调用该方法时,可以跳过这样的参数:

int variab = MyMethod(param3:50; param1:10);

C#4.0实现了一个称为“命名参数”的功能,您实际上可以按名称来传递参数,当然,您可以按任意顺序传递参数:)


20

你好可选世界

如果希望运行时提供默认参数值,则必须使用反射进行调用。与这个问题的其他建议不一样,但与VB.NET兼容。

using System;
using System.Runtime.InteropServices;
using System.Reflection;

namespace ConsoleApplication1
{
    class Class1
    {
        public static void sayHelloTo(
            [Optional,
            DefaultParameterValue("world")] string whom)
        {
            Console.WriteLine("Hello " + whom);
        }

        [STAThread]
        static void Main(string[] args)
        {
            MethodInfo mi = typeof(Class1).GetMethod("sayHelloTo");
            mi.Invoke(null, new Object[] { Missing.Value });
        }
    }
}

16

一种允许您在任何位置省略任何参数的简单方法是利用可空类型,如下所示:

public void PrintValues(int? a = null, int? b = null, float? c = null, string s = "")
{
    if(a.HasValue)
        Console.Write(a);
    else
        Console.Write("-");

    if(b.HasValue)
        Console.Write(b);
    else
        Console.Write("-");

    if(c.HasValue)
        Console.Write(c);
    else
        Console.Write("-");

    if(string.IsNullOrEmpty(s)) // Different check for strings
        Console.Write(s);
    else
        Console.Write("-");
}

字符串已经是可为null的类型,因此它们不需要??

使用此方法后,以下调用均有效

PrintValues (1, 2, 2.2f);
PrintValues (1, c: 1.2f);
PrintValues(b:100);
PrintValues (c: 1.2f, s: "hello");
PrintValues();

以这种方式定义方法时,您可以通过命名来自由设置所需的参数。有关命名和可选参数的更多信息,请参见以下链接:

命名和可选参数(C#编程指南)@ MSDN


9

我同意斯蒂芬拜耳。但是,由于它是一种Web服务,因此与使用同一方法的多个版本相比,最终用户仅使用一种形式的Web方法更容易。我认为在这种情况下,可空类型非常适合可选参数。

public void Foo(int a, int b, int? c)
{
  if(c.HasValue)
  {
    // do something with a,b and c
  }
  else
  {
    // do something with a and b only
  }  
}

+1建议。不要养成这种习惯,因为它可能会变得很凌乱。
mhenrixon

7

可选参数用于方法。如果您需要一个类的可选参数,并且您是:

  • 使用c#4.0:在类的构造函数中使用可选参数,我更喜欢这种解决方案,因为它更接近于方法完成的工作,因此更容易记住。这是一个例子:

    class myClass
    {
        public myClass(int myInt = 1, string myString =
                               "wow, this is cool: i can have a default string")
        {
            // do something here if needed
        }
    }
  • 使用c#4.0之前的c#版本:您应该使用构造函数链接(使用:this关键字),其中较简单的构造函数会导致“主构造函数”。例:

    class myClass
    {
        public myClass()
        {
        // this is the default constructor
        }
    
        public myClass(int myInt)
            : this(myInt, "whatever")
        {
            // do something here if needed
        }
        public myClass(string myString)
            : this(0, myString)
        {
            // do something here if needed
        }
        public myClass(int myInt, string myString)
        {
            // do something here if needed - this is the master constructor
        }
    }

3

正如斯蒂芬提到的,在C#中处理此问题的典型方法是重载该方法。通过使用不同的参数创建方法的多个版本,可以有效地创建可选参数。在参数较少的表单中,通常会调用方法的表单,而所有参数都会在对该方法的调用中设置默认值。


2

您可以重载您的方法。一种方法包含一个参数GetFooBar(int a),另一种方法包含两个参数,GetFooBar(int a, int b)


2

使用重载或使用C#4.0或更高版本

 private void GetVal(string sName, int sRoll)
 {
   if (sRoll > 0)
   {
    // do some work
   }
 }

 private void GetVal(string sName)
 {
    GetVal("testing", 0);
 }

1

对于大量可选参数,可以将ContainsKey方法与Dictionary的单个参数一起使用。我喜欢这种方法,因为它允许我单独传递List或T,而不必创建其他方法(例如,将参数用作过滤器,则很好)。

示例(如果不需要可选参数,则将传递新的Dictionary <string,Object>()):

public bool Method(string ParamA, Dictionary<string,Object> AddlParams) {
    if(ParamA == "Alpha" && (AddlParams.ContainsKey("foo") || AddlParams.ContainsKey("bar"))) {
        return true;
    } else {
        return false;
    }
}

0

除了默认参数外,为什么不直接从传递的querystring构造一个字典类,该实现几乎与asp.net表单使用querystring的方式相同。

即Request.QueryString [“ a”]

这将使叶子类与工厂/样板代码分离。


您可能还想使用ASP.NET签出Web服务。Web服务是通过C#类的属性自动生成的Web api。


0

晚会晚了一点,但我一直在寻找这个问题的答案,并最终想出了另一种方法。将Web方法的可选args的数据类型声明为XmlNode。如果省略了可选的arg,它将被设置为null,如果存在,则可以通过调用arg.Value获得字符串值,即

[WebMethod]
public string Foo(string arg1, XmlNode optarg2)
{
    string arg2 = "";
    if (optarg2 != null)
    {
        arg2 = optarg2.Value;
    }
    ... etc
}

这种方法还不错的是,.net生成的ws主页仍然显示参数列表(尽管您确实丢失了方便的文本输入框进行测试)。


3
这比使用可为空的类型更好吗?
Kirk Broadhurst,2010年

0

我有一个编写有7个参数的Web服务。每个都是此Web服务包装的sql语句的可选查询属性。因此,我想到了两种针对非可选参数的解决方法...两者都非常差:

method1(参数1,param2,param 3,param 4,param 5,param6,param7)method1(param1,param2,param3,param 4,param5,param 6)方法1(param1,param2,param3,param4,param5,param7 )...开始查看图片。这种方式在于疯狂。方式太多组合。

现在以一种看起来比较尴尬但应该可以工作的简单方式:method1(param1,bool useParam1,param2,bool useParam2等)

那是一个方法调用,所有参数的值都是必需的,它将处理其中的每种情况。还很清楚如何从界面使用它。

这是一个hack,但可以使用。


2
这就是存在可空参数的原因。
柯克·布罗德赫斯特

0

我必须在VB.Net 2.0 Web服务中执行此操作。我最终将参数指定为字符串,然后将其转换为所需的值。使用空字符串指定了可选参数。不是最干净的解决方案,但它可以工作。请小心捕捉所有可能发生的异常。


0

万一有人要传递回调(或delegate)作为可选参数,可以这样做。

可选的回调参数:

public static bool IsOnlyOneElement(this IList lst, Action callbackOnTrue = (Action)((null)), Action callbackOnFalse = (Action)((null)))
{
    var isOnlyOne = lst.Count == 1;
    if (isOnlyOne && callbackOnTrue != null) callbackOnTrue();
    if (!isOnlyOne && callbackOnFalse != null) callbackOnFalse();
    return isOnlyOne;
}

0

可选参数不过是默认参数!我建议你给他们两个默认参数。GetFooBar(int a = 0,int b = 0)如果没有任何重载方法,将导致a = 0,b = 0,如果您不传递任何值,如果传递1个值,将导致,则将a的值传递为0,如果您传递2的值,则将1st分配给a,将第二个分配给b。

希望这能回答你的问题。


0

如果默认值不可用,则添加可选参数的方法是使用.NET OptionalAttribute类-https://docs.microsoft.com/zh-cn/dotnet/api/system.runtime.interopservices.optionalattribute ?view = netframework-4.8

代码示例如下:

namespace OptionalParameterWithOptionalAttribute
{
    class Program
    {
        static void Main(string[] args)
        {
            //Calling the helper method Hello only with required parameters
            Hello("Vardenis", "Pavardenis");
            //Calling the helper method Hello with required and optional parameters
            Hello("Vardenis", "Pavardenis", "Palanga");
        }
        public static void Hello(string firstName, string secondName, 
            [System.Runtime.InteropServices.OptionalAttribute] string  fromCity)
        {
            string result = firstName + " " + secondName;
            if (fromCity != null)
            {
                result += " from " + fromCity;
            }
            Console.WriteLine("Hello " + result);
        }

    }
}

By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.