C#筆記 – 分部類與分部方法

分部方法

• 使用時機：使用了工具生成了C#源代碼文件，又想對裡面的行為進行定制

  • 如果不使用分部方法，而是使用繼承的話

    • internal class Base
      {
          string m_Name;
          protected virtual void OnNameChanging(string value) { }
      
          public string Name
          {
              get { return m_Name; }
              set
              {
                  OnNameChanging(value.ToUpper());
                  m_Name = value;
              }
          }
      }
      
      internal class Derived : Base
      {
          protected override void OnNameChanging(string value)
          {
              if (string.IsNullOrEmpty(value)) { return; }
          }
      }

    • 工具生成的類型必須是非密封的，所以也不能用於值類型（無法繼承）

    • 也不能用於靜態方法，因為靜態方法不能重寫

    • 在效率上，也會浪費資源

      • 即使不去重寫定制的行為，但該行為仍然會被執行，也需要生成對應的IL代碼

  • 使用分部方法

    • internal sealed partial class Base
      {
          string m_Name;
          partial void OnNameChanging(string value);
      
          public string Name
          {
              get { return m_Name; }
              set
              {
                  OnNameChanging(value.ToUpper());
                  m_Name = value;
              }
          }
      }
      
      internal sealed partial class Base
      {
          partial void OnNameChanging(string value)
          {
              if (string.IsNullOrEmpty(value)) { return; }
          }
      }

    • 生成的類可以是靜態的，也可以是值類型

    • 工具生成和開發者的代碼不是兩個獨立的類，也沒有繼承關係，就是一個類型定義的兩個部分

    • 分部方法的聲明

      • 工具

        • 包含用partial關鍵字標記的聲明

        • 無主體

      • 開發者

        • 包含用partial關鍵字標記的聲明

        • 有主體

    • 如果分部方法沒有被實現，編譯器就不會生成任何調用分部方法的IL指令以及元數據

    • 使用規則

      • 只能在分部類/結構中聲明

      • 由於方法在運行時可能實際上並不存在（沒有被實現），所以分部方法的返回類型必須為void，參數也不能用out標記

        • 可以有ref參數、泛型方法、實例/靜態方法、unsafe標記

      • 分部方法的聲明和實現需具有完全一致的簽名，兩個方法和其中參數的特性都會被合并

      • 如果沒有對應的實現部分，就不能讓委托引用該分部方法

      • 總是為private