Поделиться через


Параметры именования

Замечание

Это содержимое перепечатывается разрешением Pearson Education, Inc. из руководства по проектированию платформы: соглашения, идиомы и шаблоны для повторно используемых библиотек .NET, 2-го выпуска. Этот выпуск был опубликован в 2008 году, и книга с тех пор была полностью пересмотрена в третьем выпуске. Некоторые сведения на этой странице могут быть устаревшими.

Помимо очевидной причины удобочитаемости, важно следовать рекомендациям по именам параметров, так как параметры отображаются в документации и в конструкторе, когда средства визуального проектирования предоставляют функции просмотра Intellisense и классов.

✔️ Используйте camelCase в именах параметров.

✔️ Используйте описательные имена параметров.

✔️ Рекомендуется использовать имена на основе значения параметра, а не типа параметра.

Параметры перегрузки оператора именования

✔️ Используйте left и right для имен параметров перегрузки двоичных операторов, если параметры не имеют значения.

✔️ Используйте value для имен параметров перегрузки унарных операторов, если параметры не имеют смысла.

✔️ Рассмотрите значимые имена для параметров перегрузки оператора, если это добавляет существенную ценность.

❌ НЕ используйте сокращенные или числовые индексы для имен параметров перегрузки оператора.

© Часть 2005, 2009 Корпорация Майкрософт. Все права защищены.

Перепечатан с разрешения Pearson Education, Inc. из Руководство по проектированию: Соглашения, идиомы и шаблоны для повторного использования библиотек .NET, 2-е издание Кшиштоф Чвалина и Брэд Абрамс, опубликованное 22 октября 2008 года Addison-Wesley Профессиональный в рамках серии разработки Microsoft Windows.

См. также