C#筆記 – 參數

可選參數與命名參數

• 可選參數

  • 聲明可選參數：

    • void Dump(int x, int y = 20, int z = 30)

    • x為必備參數；y和z為可選參數，20和30分別為y和z的默認值

  • 動機：降低重載的方法數量

  • 可選參數就是在定義方法/有參屬性的參數時，為它們賦默認值，如果調用參數時沒有傳值，C#編譯器就自動嵌入參數的默認值

    • 委托的一部分參數也可以指定默認值

  • 有默認值的參數需放在沒默認值的參數之後，參數數組（如有）之前

    • 參數數組不能聲明為可選的

    • 如果調用者沒有指定值，將使用空數組代替

  • 默認值約束：

    • 必須為C#認定的基元類型/枚舉/可空的引用類型，如：

      • 數字/字符串字面量

      • null

      • const成員

      • 枚舉成員

      • default(T)操作符

    • 對於值類型可以使用與default等價的無參構造函數

  • 如果參數使用了ref/out進行標識，就不能設置默認值

  • 一旦為參數分配了默認值，編譯器會向該參數應用定制特性「Optional」，並持久性地保存到元數據中

    • 此外，編譯器向參數應用DefaultParameterValue特性，並向該特性構造器傳遞開發者指定的參數默認值。同樣，持久性地保存到元數據中。

    • Method #2 (06000002) 
      -------------------------------------------------------
      MethodName: DefaultParam (06000002)
      Flags     : [Private] [Static] [HideBySig] [ReuseSlot]  (00000091)
      RVA       : 0x000020c1
      ImplFlags : [IL] [Managed]  (00000000)
      CallCnvntn: [DEFAULT]
      ReturnType: Void
      1 Arguments
      Argument #1:  I4
      1 Parameters
      (1) ParamToken : (08000002) Name : i flags: [Optional] [HasDefault]  (00001010) Default: (I4) 10

    • 當編譯器發現某個方法調用缺失了部分實參，就會嘗試從元數據中提取默認值，將值自動嵌入到調用中。

  • 調用含有可選參數的方法時，編譯器默認我們傳遞的實參順序是與形參聲明順序是一致的

• 命名參數 

  • 在指定實參的值時，可以同時指定相應參數的名稱。編譯器將判斷參數的名稱是否正確，並將指定的值賦給這個參數。

  • 命名實參可使編譯器幫我們判斷該實參具體是要傳給哪個形參，調用方法時的參數順序變得不再重要

    • void Main()
      {
          Show("SB", "HEHE");
          Show(caption:"HEHE", text:"SB");
      }
      
      void Show(string text, string caption)
      {
          Console.WriteLine($"{text}: {caption}");
      }

  • 編譯器會根據名稱進行識別

    • 如果要對包含ref或out的參數指定名稱，需要將ref或out修飾符放在名稱之後，實參之前

    • int.TryParse("10", result: out number);

  • 命名實參與位置實參的混合使用

    • 未命名的實參稱為「位置實參」

      • 位置實參總是指向方法聲明中相應的參數，我們不能跳過參數之後，再通過命名相應位置的實參來指定

    • 所有命名實參必須放在「位置實參」之後。

      • 除非所有實參的位置與形參聲明位置保持一致，但這樣也沒必要用命名實參了

    • void Main()
      {
          Show("SB", name: "GO", caption:"HEHE"); //Valid
          Show(name: "GO", "SB", caption:"HEHE"); //InValid
          Show(text: "GO", "SB", name:"HEHE"); //Valid
      }
      void Show(string text, string caption, string name)
      {
          Console.WriteLine($"{name}({text}): {caption}");
      }

  • 實參求值順序

    • 按編寫順序求值，即使這個順序不同於參數的聲明順序