За използваната терминология

За използваната терминология

• 
  По-голямата част от техническата документация за .NET Framework е на английски език (повечето книги и в частност MSDN Library) и затова е много важно читателите да знаят английския еквивалент на всеки използван термин.
  
• 
  Много от използваните термини не са пряко свързани с .NET и са навлезли отдавна в програмисткия жаргон от английски език (напри­мер "дебъгвам", "компилирам" и "плъгин"). Тези термини ще бъдат изписвани най-често на кирилица.
  
• 
  Някои термини (например "framework" и "deployment") са трудно преводими и трябва да се използват заедно с оригинала в скобки. В настоящата книга на места такива термини са превеждани по раз­лични начини (според контекста), но винаги при първо срещане се дава и оригинални­ят термин на английски език.
  

Конвенция за кода

С цел уеднаквяване на стила на кода във всички примери от книгата, в примерите и демонстрациите от лекциите, както и в прак­тическия проект, е въведена конвенция за кода, която включва редица препоръки за фор­матирането на кода, имената на типове, членове и променливи, елементи от потребителския интерфейс и други. Ще обясним по-важните от тях:

Константите пишем с главни букви

Примери:

private const int MAX_VALUE = 4096; private const string INPUT_FILE_NAME = "input.xml";

Това е утвърдена практика, възприета от повечето програмисти на C, C++, Java и C#.

Член-променливите пишем с префикс "m"

Примери:

private Hashtable mUsersProfiles; private ArrayList mUsers;

Тази конвенция не е стандартна, но тъй като Microsoft нямат официална препоръка по този въпрос, ние възприехме тази конвенция за имену­ване на член-променливите, за да ги отличаваме от останалите промен­ливи. Префиксът "m" произхожда от думата "member" (член).

Параметрите на методите пишем с префикс "a"

Пример:

public void IsLoginValid(string aUserName, string aPassword) { // ... }

Тази конвенция също не е стандартна, но ние я възприехме, за да можем лесно да отличаваме параметрите в методите от останалите променливи, което често пъти е много полезно. Префиксът "a" произхожда от думата "argument" (аргумент на метод).

Именуване на идентификатори

Възприели сме конвенция за именуване на идентификаторите, която е близка до официалните препоръки на Microsoft (за случаите, в които Microsoft са дали препоръки) и е съобразена с принципите за именуване на член-променливи и параметри, които вече разгледахме. Ето как изг­лежда тази конвенция:

Идентификатор	Стил	Пример
пространство от имена (namespace)	Pascal Case	System.Windows.Forms
тип (клас, структура, ...)	Pascal Case	TextWriter
интерфейс (interface)	Pascal Case, префикс "I"	ISerializable
изброен тип (enum type)	Pascal Case	FormBorderStyle
изброена стойност (enum value)	Pascal Case	FixedSingle
поле само за четене (read-only field)	Pascal Case	UserIcons
поле-константа (constant)	UPPERCASE	MAX_VALUE
свойство (property)	Pascal Case	BorderColor
събитие (event)	Pascal Case	SizeChanged
метод (method)	Pascal Case	ToString()
член-променлива (field)	Pascal Case, префикс "m"	mUserProfiles
статична член-променлива (static field)	Pascal Case, префикс "m"	mTotalUsersCount
параметър на метод (parameter)	Pascal Case, префикс "a"	aFileName
локална променлива (local variable)	Camel Case	currentIndex

Именуване на контроли

При именуване на контроли използваме Pascal Case и представка, която съответства на техния тип. Не слагаме префикс "m", когато контролата е член-променлива:

Контрола	Пример
Button	ButtonOk, ButtonCancel
Label	LabelCustomerName
TextBox	TextBoxCustomerName
Panel	PanelCustomerInfo
Image	ImageProduct

Конвенции за базата данни

Използваме множествено число за именуване на таблици (например Users, Countries, StudentsCourses, …). При имената на колоните в таб­лица използваме Pascal Case (например UserName, MessageSender, UserId и т.н.).

Служебните думи в езика SQL (например SELECT, CREATE TABLE, FROM, INTO, ORDER BY и др.) изписваме с главни букви.

Каталог: dotnetbook
dotnetbook -> Кратко съдържание
dotnetbook -> Кратко съдържание

Изтегляне 9.03 Mb.

Сподели с приятели: