擷取方法重構 (C#)
[擷取方法] 是一項重構作業,可讓您輕鬆地從現有成員的程式碼片段建立新方法。
您可以使用 [擷取方法] 從現有成員的程式碼區塊內擷取選取的程式碼範圍,藉此建立新的方法。 新的擷取方法會包含選取的程式碼,而在現有成員中的已選定程式碼會取代成新方法的呼叫。 將程式碼片段轉變成自己的方法,能讓您迅速和正確地重新組織程式碼,以便重複使用並提升可讀性。
[擷取方法] 具有下列優點:
強調獨立且可重複使用的方法,進而採行最佳編碼做法。
由於組織完善,可建立自我記錄的程式碼。
當使用描述性名稱時,高層次的方法讀起來就像一系列註解。
可建立更精細的方法,以簡化覆寫。
減少程式碼重複。
若要使用擷取方法
建立名為 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; } }
選取您想要擷取的程式碼片段:
double area = PI * radius * radius;
在 [重構] 功能表上,按一下 [擷取方法]。
[擷取方法] 對話方塊隨即出現。
或者,您也可以輸入鍵盤快速鍵 CTRL+R、M,以顯示 [擷取方法] 對話方塊。
您也可以用滑鼠右鍵按一下選取的程式碼,指向 [重構],然後按一下 [擷取方法] 顯示 [擷取方法] 對話方塊。
在 [新方法名稱] 方塊中指定新方法的名稱,例如 CircleArea。
[預覽方法簽章] 下會顯示新方法簽章的預覽。
按一下 [確定]。
備註
當您使用 [擷取方法] 命令時,新方法會插入到同一類別中來源成員之後。
部分型別
如果類別是部分型別,[擷取方法] 便會產生緊接在來源成員之後的新方法。 [擷取方法] 會判斷新方法的簽章,同時在新方法中的程式碼沒有參考任何執行個體 (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();
}
}
若要解決這種情況,請將匿名方法中使用的區域變數當做類別的欄位。