参数名

选择适当的参数名称可极大改善库的可用性。 适当的参数名称应指示该参数会影响的数据或功能。

对参数名称使用 Camel 大小写。

使用描述性参数名称。

在大多数情况下,参数名称及其类型应足以确定参数的用法。

考虑使用反映参数含义的名称而不是反映参数类型的名称。

在开发人员工具和文档中,参数的类型通常都是可见的。 通过选择一个说明参数的用法或含义的名称,可以向开发人员提供有价值的信息,帮助他们找到任务所需的成员,也有助于向成员传递正确的数据。

部分版权所有 2005 Microsoft Corporation。 保留所有权利。

部分版权所有 Addison-Wesley Corporation。 保留所有权利。

设计指引的详细信息,请参阅"框架设计准则: 公约、 成语和可重复使用的模式。网络图书馆"书 Krzysztof Cwalina 和布拉德 · 艾布拉姆斯,2005年艾迪生 - 韦斯利,发表。

请参见

其他资源

类库开发的设计准则

名称准则