c# - 关于枚举后缀(种类与类型)的任何指导？

Question

我正在设计一个供公众使用的 .NET API。在我的 API 中，有一堆枚举，我正在努力决定用于后缀的约定。

在 .NET 框架中，我看到了同时使用“Kind”(例如 System.DateTimeKind)和“Type”(例如 System.IO.DriveType)的示例>).

查看 mscorlib 中的公共(public)枚举，我发现“Type”的使用频率更高，但两者仍在一些较新的类型上使用，这意味着 Microsoft 似乎没有遵循任何特定的约定。

有人对在我的 API 中使用什么有什么建议吗？是否有任何已发布的公约涵盖该主题？

我倾向于使用“Kind”作为后缀，并保留术语“Type”来处理 System.Type 对象或数据类型。

Answer 1

我从 Microsoft 了解到的与枚举相关的唯一命名约定是这样的(来自 msdn)

• Use Pascal case for Enum types and value names.
• Use abbreviations sparingly.
• Do not use an Enum suffix on Enum type names.
• Use a singular name for most Enum types, but use a plural name for Enum types that are bit fields.
• Always add the FlagsAttribute to a bit field Enum type.

它很旧，但没有看到与此相关的任何更新。

我认为没有人可以告诉您针对您的具体问题的“正确”方法，因为这两种选择都是有效的，这只是个人喜好问题。

我会说你应该与团队达成共同的策略并坚持下去。我认为每个人都使用相同的命名约定比你使用哪个更重要。

我个人使用 Type 后缀，但这只是个人喜好问题。