Именование параметров
Примечание.
Это содержимое перепечатывается разрешением Pearson Education, Inc. из руководства по проектированию платформы: соглашения, идиомы и шаблоны для повторно используемых библиотек .NET, 2-го выпуска. Этот выпуск был опубликован в 2008 году, и книга с тех пор была полностью пересмотрена в третьем выпуске. Некоторые сведения на этой странице могут быть устаревшими.
Помимо очевидной причины удобочитаемости, важно следовать рекомендациям по именам параметров, так как параметры отображаются в документации и в конструкторе, когда средства визуального проектирования предоставляют функции просмотра Intellisense и классов.
✔️ Используйте верблюдьюCasing в именах параметров.
✔️ Используйте описательные имена параметров.
✔️ Рекомендуется использовать имена на основе значения параметра, а не типа параметра.
Параметры перегрузки оператора именования
✔️ Используйте left и right для имен параметров перегрузки двоичных операторов, если нет смысла для параметров.
✔️ Используйте value для имен параметров перегрузки унарных операторов, если нет смысла для параметров.
✔️ РАССМОТРИТе значимые имена для параметров перегрузки оператора, если это добавляет значительное значение.
❌ НЕ используйте сокращенные или числовые индексы для имен параметров перегрузки оператора.
Фрагменты: © Корпорация Майкрософт (Microsoft Corporation), 2005, 2009. Все права защищены.
Перепечатано с разрешения Pearson Education, Inc. из книги Инфраструктура программных проектов. Соглашения, идиомы и шаблоны для многократно используемых библиотек .NET (2-е издание), авторы: Кржиштоф Цвалина (Krzysztof Cwalina) и Брэд Абрамс (Brad Abrams). Книга опубликована 22 октября 2008 г. издательством Addison-Wesley Professional в рамках серии, посвященной разработке для Microsoft Windows.