Quy ước đặt tên cho lớp hằng số trong C#: số nhiều hoặc số ít?

Question

Các nguyên tắc rõ ràng cho việc liệt kê ...

Hãy sử dụng tên ít nhất để đếm, trừ khi giá trị của nó là trường bit.

(Nguồn: http://msdn.microsoft.com/en-us/library/ms229040.aspx)

... nhưng không quá rõ ràng cho một lớp học của các hằng số (hoặc read-only tĩnh lĩnh vực/Properties). Ví dụ, tên của lớp này là số ít hay số nhiều?

public static class Token // or Tokens? 
{ 
    public const string Foo = "Foo"; 
    public const string Bar = "Bar"; 
    public const string Doo = "Doo"; 
    public const string Hicky = "Hicky"; 
} 

Answer 1

Tôi sẽ sử dụng số nhiều: Tokens. Điều này ngụ ý rằng lớp tĩnh đang phục vụ như là một tập hợp các mục của một số loại (có kiểu thời gian chạy không phải là của lớp).

Mặt khác, các trường của điều tra là trường hợp của kiểu liệt kê. Ví dụ: TypeCode.Stringlà a TypeCode. Thật lạ khi nói rằng TypeCodes.String là TypeCodes.

Tuy nhiên, trong Tokens ví dụ của bạn, bằng cách sử dụng ít cho chúng ta Token.Foo, mà là một mã thông báo, nhưng nó không phải là một Token (nó là một string).

(Hoặc, nếu bạn sử dụng tên lớp nhiều, Tokens.Foo là một string, không phải là một Tokens Ack.!)

Answer 2

Tôi không có bất kỳ tiêu chuẩn đặt tên chính thức nào để liên kết, nhưng tôi có thể cho bạn biết tôi sẽ làm gì.

Tôi sẽ sử dụng tên số nhiều: tokens

Answer 3

Kể từ khi cả hai đều sử dụng về cơ bản theo cùng một cách, và là khái niệm điều tương tự, tôi khuyên bạn nên chỉ theo các hướng dẫn enum.

Answer 4

Tôi sẽ sử dụng tên số nhiều: Tokens

Tuy nhiên bạn có thể xem xét việc tạo ra một Token lớp để giữ giá trị const.

Điều này tương tự như System.Windows.Media.Colors, ví dụ: Colors.Blue trả về phiên bản System.Windows.Media.Color.

public class Token 
{ 
    public Token(string value) 
    { 
     Value = value; 
    } 

    public string Value { get; private set; } 

    public static implicit operator string(Token token) 
    { 
     return token == null ? null : token.Value; 
    } 

    public bool Equals(string value) 
    { 
     return String.Equals(Value, value); 
    } 

    public override bool Equals(object obj) 
    { 
     var other = obj as Token; 
     if (other == null) 
     { 
      return false; 
     } 

     return Equals(other.Value); 
    } 

    public override int GetHashCode() 
    { 
     return Value.GetHashCode(); 
    } 

    public override string ToString() 
    { 
     return Value; 
    } 
} 

public static class Tokens 
{ 
    public static readonly Token Foo = new Token("Foo"); 
} 

class Program 
{ 
    static void Main(string[] args) 
    { 
     // You can use it as if they were string constants. 
     string token = Tokens.Foo; 
     bool areEquals = String.Equals(token, Tokens.Foo); 
    } 
}