Nazewnictwo parametrów
Uwaga
Ta zawartość jest drukowana przez uprawnienie Pearson Education, Inc. z Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2nd Edition. Wydanie to zostało opublikowane w 2008 roku, a książka została w pełni zmieniona w trzecim wydaniu. Niektóre informacje na tej stronie mogą być nieaktualne.
Poza oczywistą przyczyną czytelności należy postępować zgodnie z wytycznymi dotyczącymi nazw parametrów, ponieważ parametry są wyświetlane w dokumentacji i w projektancie, gdy narzędzia do projektowania wizualnego zapewniają funkcję IntelliSense i funkcje przeglądania klas.
✔️ Do używać camelCasing w nazwach parametrów.
✔️ Należy użyć opisowych nazw parametrów.
✔️ ROZWAŻ użycie nazw na podstawie znaczenia parametru, a nie typu parametru.
Parametry przeciążenia operatora nazewnictwa
✔️ Użyj polecenia left i right dla nazw parametrów przeciążenia operatora binarnego, jeśli nie ma znaczenia dla parametrów.
✔️ Należy użyć dla value jednoargumentowych nazw parametrów przeciążenia operatora, jeśli nie ma znaczenia dla parametrów.
✔️ ROZWAŻ opisowe nazwy parametrów przeciążenia operatora, jeśli to spowoduje dodanie znaczącej wartości.
❌ NIE używaj skrótów ani indeksów liczbowych dla nazw parametrów przeciążenia operatora.
© Części 2005, 2009 Microsoft Corporation. Wszelkie prawa zastrzeżone.
Reprinted by permission of Pearson Education, Inc. from Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2nd Edition by Krzysztof Cwalina and Brad Abrams, published oct 22, 2008 by Addison-Wesley Professional w ramach Microsoft Windows Development Series.