首页 > 代码库 > C# 重载

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)