c# - 何时在方法上使用复数与集合词

Question

我正在为一个模块创建一个 API，在我的类中创建了几个方法之后，我问自己这个问题。

现在，举个例子，我正在这样做:

public Company GetMonitoredCompany( String companyName ) { ... }
public List<Company> GetMonitoredCompanies( ) { ... }

但我意识到有好几次我使用其他 API/服务，有时它们的名称中有 Collection 可能像这样:

public List<Company> GetMonitoredCompanyCollection( ) { ... }

这个有规定吗？一种模式？或者任何一种方式都应该可以吗？

Answer 1

使用能清楚显示方法用途的最短、最简单的名称。并在您的项目中保持一致。

在这个例子中，如果没有其他考虑，我会使用这个名字:

GetMonitoredCompanies

因为它更短更清晰。

(我也会返回一个只读的 ICollection 或 IEnumerable，除非你有一些特定的原因不这样做。)