Отправляет email-рассылки с помощью сервиса Sendsay
  Все выпуски  

Язык программирования C# и платформа .NET [CSharp & .NET] 2001.10.09


Служба Рассылок Subscribe.Ru

C Sharp and Dot NET

  • О рассылке
  • Письма
    • Ссылки
    • О концепциях
    • Установка Visual Studio Beta 2
    • Оформление кода
  • Оформление кода

О рассылке

Было высказано пожелание увеличить частоту рассылки для того, чтобы была возможность быстро получать ответы на вопросы. Я могу выпускать рассылку часто. Дело за малым - за вашими вопросами и ответами ;)

Письма

Ссылки

Глава из "Professional ASP.NET"

Patterns with C#

О концепциях

-----Original Message-----
From: Andrew Ezhguroff
Sent: Thursday, October 04, 2001 2:55 AM

    Здравствуйте.

    Вы неправильно даете последовательность возникновения концепций. Классы
появились (в языке Simula-67) за много лет до модулей (появившихся в языке
Modula) и даже раньше типов данных (насколько я помню, концепция типов была
создана Хоором и впервые реализована в языке Pascal).

    С уважением, Андрей Ежгуров.

Установка Visual Studio Beta 2

-----Original Message-----
From: polyana
Sent: Thursday, October 04, 2001 3:26 PM

У меня проблема. VisualStudio.NET beta2 ставится на WindowsXP, а MSDN - нет

Оформление кода

 -----Original Message----- From:
Sergey Polischuk Sent: Monday, October 08, 2001
2:12 PM
Subject: C# соглашение о кодировании


Добрый день, Сергей!

С большим интересом читаю Вашу рассылку.
Хотим начать разработку проекта и стали перед
дилеммой: какие использовать соглашения о кодировании.
Речь идет о венгерской системе. Можно, конечно, использовать
соглашения для VB.

Хотелось бы узнать Ваше мнение о
-    Соглашении об именовании объектов, переменных, процедур
-    Стандартных форматах для меток и комментариев в коде
-    Руководящих принципах для задания пробелов, форматирования и отступов.

[SergeyR: ниже - мое мнение, другие мнения и дополнения приветствуются]

Оформление кода

имена

классы именуются с большой буквы - SomeClass, интерфейсы именуются с префиксом I - IAnimal

Имена переменных, свойств и методов должны начинаться с большой буквы и нести смысловую нагрузку.

string EmployeeName; // Name of an employee.
int AttendanceCounter; // Variable of type long.
long NumberOfBytes; // Variable of type long.

методы нужно называть единообразно. AppendEmployee и AppendManager лучше чем AppendEmployee и ManagerAppend


логические переменные и функции возвращающие bool начинать с Is
bool IsFileFound...

переменные циклов традиционно - i, j, k

имена сборок начинать с названия компании - MyCompany.MyAssembly

отступы и пробелы

меток в коде, написанном вручную, практически не бывает

    комментарии бывают четырех стилей
  • xml-комментарии - оставлять так как их генерирует IDE
  • однострочные комментарии - через пробел от комментируемого или на отдельной строке
  • многострочные комментарии - на отдельных строках (с промежуточными звездочками или нет - не важно
  • блоки кода закомментировать насмерть можно при помощи препроцессора, а просто пометить - директивами #region и #endregion

Отступы - по четыре пробела

пробелы ставятся после ключевых слов и не ставятся между именем функции и скобкой

пробелы ставятся после знаков препинания - запятой в списке параметров функции и точки с запятой в операторе цикла, кроме for (;;)

Пробелы ставятся вокруг бинарных операций и не ставятся между унарной операцией и операндом

скобки друг под другом, скобки лучше ставить даже вокруг одиночного оператора (возможно прийдется вписывать трассировку или еще что, кроме того, это увеличивает читаемость). Исключение - длинная (больше двух) конструкция с else-if.

прочее

Переменные определяются как можно ближе к месту первого присваивания/использования.


Если Вам есть что сказать или о чем спросить - пишите на адрес mailto:level3@mail.ru

С уважением и наилучшими пожеланиями,
Сергей Радкевич.



http://subscribe.ru/
E-mail: ask@subscribe.ru
Отписаться
Убрать рекламу
Рейтингуется SpyLog

В избранное