擷取方法重構 (C#)

[擷取方法] 是一項重構作業，可讓您輕鬆地從現有成員的程式碼片段建立新方法。

您可以使用 [擷取方法] 從現有成員的程式碼區塊內擷取選取的程式碼範圍，藉此建立新的方法。新的擷取方法會包含選取的程式碼，而在現有成員中的已選定程式碼會取代成新方法的呼叫。將程式碼片段轉變成自己的方法，能讓您迅速和正確地重新組織程式碼，以便重複使用並提升可讀性。

[擷取方法] 具有下列優點：

• 強調獨立且可重複使用的方法，進而採行最佳編碼做法。

• 由於組織完善，可建立自我記錄的程式碼。

  當使用描述性名稱時，高層次的方法讀起來就像一系列註解。

• 可建立更精細的方法，以簡化覆寫。

• 減少程式碼重複。

若要使用擷取方法

1. 建立名為 ExtractMethod的主控台應用程式，再以下列範例程式碼取代 Program。

   class A
   {
       const double PI = 3.141592;
   
       double CalculatePaintNeeded(double paintPerUnit, double radius)
       {
           // Select any of the following:
           // 1. The entire next line of code.
           // 2. The right-hand side of the next line of code.
           // 3. Just "PI *" of the right-hand side of the next line
           //    of code (to see the prompt for selection expansion).
           // 4.  All code within the method body.
           // ...Then invoke Extract Method.
   
           double area = PI * radius * radius;
   
           return area / paintPerUnit;
       }
   }
   

2. 選取您想要擷取的程式碼片段：

   double area = PI * radius * radius;
   

3. 在 [重構] 功能表上，按一下 [擷取方法]。

   [擷取方法] 對話方塊隨即出現。

   或者，您也可以輸入鍵盤快速鍵 CTRL+R、M，以顯示 [擷取方法] 對話方塊。

   您也可以用滑鼠右鍵按一下選取的程式碼，指向 [重構]，然後按一下 [擷取方法] 顯示 [擷取方法] 對話方塊。

4. 在 [新方法名稱] 方塊中指定新方法的名稱，例如 CircleArea。

   [預覽方法簽章] 下會顯示新方法簽章的預覽。

5. 按一下 [確定]。

備註

當您使用 [擷取方法] 命令時，新方法會插入到同一類別中來源成員之後。

部分型別

如果類別是部分型別，[擷取方法] 便會產生緊接在來源成員之後的新方法。[擷取方法] 會判斷新方法的簽章，同時在新方法中的程式碼沒有參考任何執行個體 (Instance) 資料時建立靜態方法。

泛型型別參數

如果您擷取的方法有不受限制的泛型型別參數，產生的程式碼就不會將 ref 修飾詞 (Modifier) 加入至參數，除非已指派值給參數。如果擷取的方法能夠將參考型別當做泛型型別引數，則您應手動將 ref 修飾詞加入至方法簽章中的參數。

匿名方法

如果嘗試擷取匿名方法 (Anonymous Method) 的部分，而其中參考了在該匿名方法外部宣告或參考的區域變數，則 Visual Studio 將會警告您可能發生語意變更。

若匿名方法使用區域變數的值，會在執行匿名方法時取得該值。將匿名方法擷取至其他方法內時，則會在呼叫擷取方法時取得區域變數的值。

下列範例將說明這個語意變更。如果執行這段程式碼，主控台顯示的會是 11。如果您使用 [擷取方法] 將程式碼註解標記的程式碼區域擷取到自己的方法內，然後執行重構的程式碼，則主控台將會顯示 10。

class Program
{
    delegate void D();
    D d;
    static void Main(string[] args)
    {
        Program p = new Program();
        int i = 10;
        /*begin extraction*/
            p.d = delegate { Console.WriteLine(i++); };
        /*end extraction*/
        i++;
        p.d();
    }
}

若要解決這種情況，請將匿名方法中使用的區域變數當做類別的欄位。

請參閱

概念

重構 (C#)