C# 重载

定义

  成员的签名包含成员的名称和参数列表。每个成员签名在类型中必须是唯一的。只要成员的参数列表不同，成员的名称可以相同。如果类型的两个或多个成员是同类成员（方法、属性、构造函数等），它们具有相同的名称和不同的参数列表，则称该同类成员进行了重载。例如，Array 类包含两个 CopyTo 方法。第一个方法采用一个数组和一个Int32 值，第二个方法采用一个数组和一个 Int64 值。

 

在设计重载方法的时候应该注意一下事项

1  避免随意更改重载中的参数名称。如果某个重载的一个参数与另一个重载的一个参数表示相同的输入，则这两个参数应具有同样的名称。

  例如，不要执行下面的操作：

  public void Write(string message, FileStream stream){}
  public void Write(string line, FileStream file, bool closeStream){}

这些重载的正确定义如下所示

public void Write(string message, FileStream stream){}
public void Write(string message, FileStream stream, bool closeStream){}

 

保持重载成员参数的顺序一致性。在所有重载中，同名参数的位置应该相同。

例如，不要执行下面的操作：

public void Write(string message, FileStream stream){}
public void Write(FileStream stream,  string message, bool closeStream){}

这些重载的正确定义如下所示：

public void Write(string message, FileStream stream){}
public void Write(string message, FileStream stream, bool closeStream){}

 

以上两种写法结构清晰，增强代码的可读性，更加适合规范。

此准则有两项约束：

• 如果重载采用变量参数列表，则该列表必须是最后一个参数。

• 如果重载采用 out 参数，按照约定，这类参数应作为最后的参数

如果需要具有扩展性，将最长的重载作为虚重载。较短的重载只应逐步调用较长的重载。

下面的代码示例对此进行了演示。

public void Write(string message, FileStream stream)
{
    this.Write(message, stream, false);
}
public virtual void Write(string message, FileStream stream, bool closeStream)
{
    // Do work here.
}

此写法减少多余的代码，利于维护。

不要对重载成员使用 ref 或 out 修饰符。

public void Write(string message, int count)

...public void Write(string message, out int count)