Today, I am going to explain C# coding standards naming conventions for best practice when you are developing a .NET application.

Terminology There are following three terminologies are used to declare C# and .NET naming standards. 

• Camel Case (camelCase): In this standard, the first letter of the word always in small letter and after that each word starts with a capital letter.
• Pascal Case (PascalCase): In this the first letter of every word is in capital letter.
• Underscore Prefix (_underScore): For underscore ( __ ), the word after _ use camelCase terminology.

Native DataType

Always use native datatype instead of .NET CTS type. For example, use int instead of Int32 or Int64.

1. //Good  
2. private int _salary = 100;  
3. //Bad  
4. private Int16 _salary = 100;  
5. private Int32 _salary=100;  

Class

Always use PascalCase for class names. Try to use noun or noun phrase for class name. Do not give prefixes. Do not use underscores.

1. public partial class About : Page  
2. {  
3.    //…  
4. }  

Methods

Always use PascalCase for method names. Use maximum 7 parameters in a method.

1. public string GetPosts(string postId)  
2. {  
3.    //…  
4. }  

Note: Don’t use name as all character in CAPS.

Arguments and Local Variable

Always use camelCase with method arguments and local variables. Don’t use Hungarian notation for variables.

1. public string GetPosts(string postId  
2. {  
3.    int numberOfPost = 0;   
4. }  

Note: Don’t use abbreviations for any words and don’t use underscore ( _ ) in between any name.

Property

Use PascalCase for property. Never use Get and Set as prefix with property name.

1. private int _salary = 100;  
2. public int Salary  
3. {  
4.     get  
5.     {  
6.         return _salary;  
7.     }  
8.     set  
9.     {  
10.         _salary = value;  
11.     }  
12. }  

Note: Don’t use name with start with numeric character.

Interface

Always use letter “I” as prefix with name of interface. After letter I, use PascalCase.

1. public interface IUser  
2. {  
3.    /// <summary>  
4.    /// Check user is exists or not  
5.    /// </summary>  
6.    /// <returns>return bool value</returns>  
7.    bool ValidateUser();  
8. }  

Private Member Variable

Always try to use camelCase terminology prefix with underscore ( _ ).

1. private int _salary = 100;  

Public Member Variable

Always use PascalCase for public member variable,

1. public int Salary = 100;  

Member variable

Declare member variable at the top of the class, If class has static member then it will come at the top most and after that other member variable.

1. public class Account  
2. {  
3.     public static string BankName;  
4.     public static decimal Reserves;  
5.     public string Number  
6.     {  
7.         get;  
8.         set;  
9.     }  
10.     public DateTime DateOpened  
11.     {  
12.         get;  
13.         set;  
14.     }  
15.     public DateTime DateClosed  
16.     {  
17.         get;  
18.         set;  
19.     }  
20.     public decimal Balance  
21.     {  
22.         get;  
23.         set;  
24.     }  
25.     // Constructor  
26.     public Account()  
27.     {  
28.         // …  
29.     }  
30. }  

Enum

Always use PascalCasing as default naming standard. 

• Use a singular type name for an enumeration unless its values are bit fields.
• Use a plural type name for an enumeration with bit fields as values, also called flags enum.
• Do not use an “Enum” suffix in enum type names.
• Do not use “Flag” or “Flags” suffixes in enum type names.
• Do not use a prefix on enumeration value names.  

1. enum MailType  
2. {  
3.    Html,  
4.    PlainText,  
5.    Attachment  
6. }  

Namespace

Always use PascalCase for namespace.

namespace NextProgramming.Domain

Standard Abbreviation for Standard Controls.   

Events Names   Events are associated with actions. Therefore, events are named with verbs. For example, Loaded, Clicked, and Printing.

• Give events names with a concept of before, current, and after, using the present and past tenses. Depending on the page, window, control, or class, the event names for a page can be, Initialized, PreRender, Rendering, PostRender, and Exited. A button event can be OnClick.
• Event handlers use “EventHandler” suffix, as shown in the following example:
• public delegate void ClickedEventHandler(object sender, ClickedEventArgs e);
• Use two parameters named sender and e in event handlers.
• Name event argument classes with the “EventArgs” suffix. 

Fields Names   Use PascalCasing in field names. Do not use a prefix for field names. Do not use underscores in field names.   Naming a DLL or Assembly   Assemblies or DLLs are created for a major functionality such as a math library. The library name should be, CompanyName.Component.Dll. For example, Mindcracker.Math.dll and Mindcracker.Data.dll.   Naming Parameters   Use camelCasing and descriptive parameter names. Use names based on a parameter’s meaning rather than the parameter’s type.    Naming Resources Use PascalCasing and descriptive names in resource keys. Use only alphanumeric characters and underscores in naming resources.  Summary   Today we learned coding standard naming conventions in C#. Thanks for reading this article, hope you enjoyed it.

Source: https://www.c-sharpcorner.com/

 32 total views,  1 views today

1. Язык программирования C# 2010 и платформа .NET 4 – Эндрю Троелсен
2. C# 4.0 и платформа .NET 4 для профессионалов – Кристиан Нейгел
3. CLR via C#. Программирование на платформе Microsoft .NET Framework 4.5 на языке C# – Джеффри Рихтер
4. C#. Программирование для профессионалов – Джон Скит
5. C# 4.0. Полное руководство – Герберт Шилдт

 43 total views