C# API:C方法命名约定:GetPageCount或GetTotalPage
我有一个IPager接口C# API:C方法命名约定:GetPageCount或GetTotalPage,c#,api,naming-conventions,C#,Api,Naming Conventions,我有一个IPager接口 GetTotalPage听起来比GetPageCount更传统吗?对我来说,GetPageCount听起来更好,因为它更接近Linq扩展的x.Count或x.Count等代码的常用用法 因此,它清楚地解释了自己。获取-例如,返回某物。Page-有问题的变量和Count-在方法中,当应用于有问题的变量时,将返回who的返回值。对我来说,GetPageCount听起来更好,因为它更接近Linq扩展的x.Count或x.Count等代码的常用用法 因此,它清楚地解释了自己。获
GetTotalPage听起来比GetPageCount更传统吗?对我来说,GetPageCount听起来更好,因为它更接近Linq扩展的x.Count或x.Count等代码的常用用法
因此,它清楚地解释了自己。获取-例如,返回某物。Page-有问题的变量和Count-在方法中,当应用于有问题的变量时,将返回who的返回值。对我来说,GetPageCount听起来更好,因为它更接近Linq扩展的x.Count或x.Count等代码的常用用法
因此,它清楚地解释了自己。获取-例如,返回某物。Page-有问题的变量和Count-在方法中,当应用于有问题的变量时,返回的是谁的返回值。老实说,我认为没有太大区别。使用你或你的公司喜欢的任何东西。老实说,我不认为有多大区别。使用你或你的公司喜欢的任何东西。为什么不简单地计算一下呢 您已经扩展了一些实现IPager的东西,该方法可能不需要进一步扩展页面 在列表的情况下,您得到的是Count而不是getcount 这真的是个人喜好。如果您将IPager接口实现为一种不同的类型,而该类型实际上不是一个页面,该怎么办?为什么不简单地计算一下呢 您已经扩展了一些实现IPager的东西,该方法可能不需要进一步扩展页面 在列表的情况下,您得到的是Count而不是getcount
这真的是个人喜好。如果您将IPager界面实现为一种不同的类型,而该类型实际上不是页面,该怎么办?一般来说:选择最有意义的名称 在本例中,我将使用GetPageCount,因为它是自描述的,并且还暗示了int类型,而GetTotalPages则可能返回类似IEnumerable的内容 GetPageCount也遵循以下顺序: 它是一个能手/能手吗?->收到 一般来说,什么是获取/设置?->页 什么是特定的获取/设置?->计数
此顺序使您更容易找到您要查找的内容。一般来说:选择最有意义的名称 在本例中,我将使用GetPageCount,因为它是自描述的,并且还暗示了int类型,而GetTotalPages则可能返回类似IEnumerable的内容 GetPageCount也遵循以下顺序: 它是一个能手/能手吗?->收到 一般来说,什么是获取/设置?->页 什么是特定的获取/设置?->计数
这种顺序使您更容易找到您要查找的内容。代码应该是自文档的,因此使用任何描述其功能的名称都可以。只要出现的下一个家伙不经过1000页的文档就理解了你的想法,你就完成了你的工作。代码应该是自文档的,所以使用任何描述其功能的名称都可以。只要下一个来的人不看1000页的文档就能理解你的想法,你就完成了你的工作。这是主观的。两者都很好,选择一个你更喜欢的。@DanielHilgarth这就是为什么我要问这个问题:如果我有一个新的开发人员接管一个项目,这更有意义!下面的一些解释让很多老师同意,这些解释是有道理的,但是,它们都是主观的。这是主观的。两者都很好,选择一个你更喜欢的。@DanielHilgarth这就是为什么我要问这个问题:如果我有一个新的开发人员接管一个项目,这更有意义!下面的一些解释让很多老师同意,这些解释是有道理的,但是,所有的解释都是主观的。我只想计算页数。Get前缀实际上只是噪音。@MatthewWatson:如果它只是一个属性,我同意。如果它是一个昂贵的方法,我会继续使用Get…我只会选择PageCount。Get前缀实际上只是噪音。@MatthewWatson:如果它只是一个属性,我同意。如果它是一个昂贵的方法,我会使用Get…那么你会在每个返回内容的方法前面加上Get这个词?我不确定这会增加多少价值。。。数学,GetMax。。。而不是数学,马克斯。。。例如我就叫它PageCount。但我想这是个人喜好的问题!所以你把Get放在每个返回东西的方法前面?我不确定这会增加多少价值。。。数学,GetMax。。。而不是数学,马克斯。。。例如我就叫它PageCount。但我想这是个人喜好的问题!
public interface IPager
{
int RecordCount { get; }
int PageNumber { get; }
int PageSize { get; }
}
public static class PagerExtensions
{
public static int GetPageCount(this IPager pager)
{
var totalPages = pager.RecordCount / pager.PageSize;
if (pager.RecordCount % pager.PageSize > 0)
totalPages += 1;
return totalPages;
}
}