Công ước đặt tên Enum - số nhiều

Tôi đang hỏi câu hỏi này mặc dù đã đọc tương tự nhưng không chính xác những gì tôi muốn tại quy ước đặt tên C # cho enum và thuộc tính phù hợp

Tôi thấy rằng tôi có xu hướng đặt tên enums ở số nhiều và sau đó 'sử dụng' chúng dưới dạng số ít, ví dụ:

public enum EntityTypes {
  Type1, Type2
}

public class SomeClass {
  /*
    some codes
  */

  public EntityTypes EntityType {get; set;}

}

Tất nhiên nó hoạt động và đây là phong cách của tôi, nhưng bất cứ ai cũng có thể tìm thấy vấn đề tiềm năng với quy ước như vậy? Tôi có một cách đặt tên "xấu xí" với từ "Status":

public enum OrderStatuses {
  Pending, Fulfilled, Error, Blah, Blah
}

public class SomeClass {
  /*
    some codes
  */

  public OrderStatuses OrderStatus {get; set;}

}

Thông tin bổ sung: Có thể câu hỏi của tôi không đủ rõ ràng. Tôi thường phải suy nghĩ kỹ khi đặt tên các biến của các loại enum được xác định của tôi. Tôi biết cách thực hành tốt nhất, nhưng nó không giúp tôi dễ dàng đặt tên cho các biến đó.

Tôi có thể không thể tiết lộ tất cả các thuộc tính enum của mình (nói "Trạng thái") là "MyStatus".

Câu hỏi của tôi: Bất cứ ai cũng có thể tìm thấy vấn đề tiềm năng với quy ước của tôi được mô tả ở trên? Nó KHÔNG phải là về thực hành tốt nhất.

Câu hỏi viết lại:

Chà, tôi đoán tôi nên đặt câu hỏi theo cách này: Ai đó có thể đưa ra một cách chung chung để đặt tên loại enum sao cho khi sử dụng, việc đặt tên của enum 'dụ' sẽ khá đơn giản?

Microsoft khuyên bạn nên sử dụng số ít cho Enums trừ khi các trường Enumđại diện cho bit (cũng sử dụng trường bit FlagsAttribute). Xem Quy ước đặt tên kiểu liệt kê (một tập hợp con của Nguyên tắc đặt tên của Microsoft ).

Để trả lời làm rõ của bạn, tôi thấy không có gì sai với một trong những điều sau đây:

public enum OrderStatus { Pending, Fulfilled, Error };

public class SomeClass { 
    public OrderStatus OrderStatus { get; set; }
}

hoặc là

public enum OrderStatus { Pending, Fulfilled, Error };

public class SomeClass {
    public OrderStatus Status { get; set; }
}

Tôi bắt đầu đặt tên enums ở số nhiều nhưng từ đó đã đổi thành số ít. Dường như có ý nghĩa hơn trong bối cảnh nơi chúng được sử dụng.

enum Status { Unknown = 0, Incomplete, Ready }

Status myStatus = Status.Ready;

So với:

Statuses myStatus = Statuses.Ready;

Tôi tìm thấy hình thức số ít để âm thanh tự nhiên hơn trong bối cảnh. Chúng tôi đồng ý rằng khi tuyên bố enum, xảy ra ở một nơi, chúng tôi nghĩ rằng "đây là một nhóm người hay nói", nhưng khi sử dụng nó, có lẽ ở nhiều nơi, chúng tôi nghĩ rằng "đây là bất cứ điều gì" .

Tình huống không bao giờ thực sự áp dụng cho số nhiều.

An enumhiển thị một thuộc tính của cái gì đó hoặc cái khác. Tôi sẽ đưa ra một ví dụ:

enum Humour
{
  Irony,
  Sarcasm,
  Slapstick,
  Nothing
}

Bạn có thể có một loại, nhưng hãy thử nghĩ về nó trong nhiều, thay vì số nhiều:

Humour.Irony | Humour.Sarcasm

Thay vì

Humours { Irony, Sarcasm }

Bạn có khiếu hài hước, bạn không có cảm giác nhục nhã.

Nói chung, khuyến nghị thực hành tốt nhất là số ít, ngoại trừ những enum có thuộc tính [Cờ] được gắn vào chúng, (và do đó có thể chứa các trường bit), nên ở dạng số nhiều.

Sau khi đọc câu hỏi đã được chỉnh sửa của bạn, tôi có cảm giác bạn có thể nghĩ rằng tên thuộc tính hoặc tên biến phải khác với tên loại enum ... Không. Sau đây là hoàn toàn tốt ...

  public enum Status { New, Edited, Approved, Cancelled, Closed }

  public class Order
  {
      private Status stat;
      public Status Status
      { 
         get { return stat; }
         set { stat = value; }
      }
  }

Đây là một trong số ít những nơi mà tôi không đồng ý với quy ước đủ để chống lại nó. TBH, tôi ghét rằng định nghĩa của một enum và thể hiện của nó có thể có cùng tên. Tôi đặt hậu tố tất cả các Enums của tôi bằng "Enum" bởi vì nó cho thấy rõ bối cảnh của nó là gì trong bất kỳ cách sử dụng nào. IMO nó làm cho mã dễ đọc hơn nhiều.

public enum PersonTypesEnum {
    smart,
    sad,
    funny,
    angry
}


public class Person {   
    public PersonTypesEnum PersonType {get; set;}
}

Không ai sẽ nhầm lẫn giữa enum là gì và ví dụ của nó là gì.

Nếu bạn đang cố viết mã đơn giản nhưng bị cấm như thế này:

    public class Person
    {
        public enum Gender
        {
            Male,
            Female
        }
        //Won't compile: auto-property has same name as enum
        public Gender Gender { get; set; }  
    }

Lựa chọn của bạn là:

1. Bỏ qua khuyến nghị MS và sử dụng tiền tố hoặc hậu tố trên tên enum:

   public class Person
   {
       public enum GenderEnum
       {
           Male,
           Female
       }
       public GenderEnum Gender { get; set; }
   }

2. Di chuyển định nghĩa enum bên ngoài lớp, tốt nhất là vào một lớp khác. Đây là một giải pháp dễ dàng cho những điều trên:

   public class Characteristics
   {
       public enum Gender
       {
           Male,
           Female
       }
   }
   public class Person
   {
       public Characteristics.Gender Gender { get; set; }  
   }

Thực hành tốt nhất - sử dụng số ít. Bạn có một danh sách các vật phẩm tạo nên một Enum. Sử dụng một mục trong danh sách nghe có vẻ lạ khi bạn nói Versions.1_0. Nó có ý nghĩa hơn để nóiVersion.1_0 vì chỉ có một Phiên bản 1_0.

Đến muộn một chút ...

Có một sự khác biệt quan trọng giữa câu hỏi của bạn và câu hỏi bạn đề cập (mà tôi đã hỏi ;-):

Bạn đặt định nghĩa enum ra khỏi lớp, cho phép bạn có cùng tên cho enum và thuộc tính:

public enum EntityType { 
  Type1, Type2 
} 

public class SomeClass { 
  public EntityType EntityType {get; set;} // This is legal

}

Trong trường hợp này, tôi sẽ theo MS guidelin và sử dụng tên số ít cho enum (số nhiều cho cờ). Đó là giải pháp đơn giản nhất.

Vấn đề của tôi (trong câu hỏi khác ) là khi enum được định nghĩa trong phạm vi của lớp, ngăn chặn việc sử dụng một thuộc tính được đặt tên chính xác theo enum.

Trên luồng khác, quy ước đặt tên C # cho enum và thuộc tính khớp ai đó đã chỉ ra điều tôi nghĩ là một ý tưởng rất hay:

"Tôi biết đề xuất của tôi đi ngược lại các quy ước Đặt tên .NET, nhưng cá nhân tôi có tiền tố enum với 'E' và cờ enum với 'F' (tương tự như cách chúng tôi đặt tiền tố Giao diện với 'I')."