CA1025:必須以參數陣列取代重複的引數
型別名稱 |
ReplaceRepetitiveArgumentsWithParamsArray |
CheckId |
CA1025 |
分類 |
Microsoft.Design |
中斷變更 |
中斷 |
原因
公用或型別中的公用或保護之方法的參數超過三個,而且它的最後三個參數都是相同的型別。
規則描述
當引數的正確數目未知,而且變數引數 (Variable Argument) 都是相同的型別 (或可以相同的型別傳遞) 時,需使用參數陣列而不是重複的引數。 例如,WriteLine 方法會提供一般用途的多載,可使用參數陣列接受任何數目的 Object 引數。
如何修正違規
若要修正此規則的違規情形,請以參數陣列取代重複的引數。
隱藏警告的時機
您可以放心地隱藏此規則的警告,但是這個設計可能會造成可用性問題。
範例
下列範例顯示違反此規則的型別。
using System;
namespace DesignLibrary
{
public class BadRepeatArguments
{
// Violates rule: ReplaceRepetitiveArgumentsWithParamsArray.
public void VariableArguments(object obj1, object obj2, object obj3, object obj4) {}
public void VariableArguments(object obj1, object obj2, object obj3, object obj4, object obj5) {}
}
public class GoodRepeatArguments
{
public void VariableArguments(object obj1) {}
public void VariableArguments(object obj1, object obj2) {}
public void VariableArguments(object obj1, object obj2, object obj3) {}
public void VariableArguments(params Object[] arg) {}
}
}