Udostępnij za pomocą


Parametry nazewnictwa

Uwaga / Notatka

Ta treść jest przedrukowana za zgodą Pearson Education, Inc. z Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2. wydanie. 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.

✔️ Używaj 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.

Nazywanie parametrów przeciążenia operatora

✔️ Zaleca się używanie left i right jako nazw parametrów przeciążenia operatora binarnego, jeśli parametry nie mają znaczenia.

✔️ Należy użyć value dla jednoargumentowego przeciążenia operatora, jeśli nazwy parametrów nie mają znaczenia.

✔️ ROZWAŻ znaczące nazwy parametrów przeciążenia operatora, jeśli to dodaje 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.

Przedrukowane za zgodą Pearson Education, Inc. z Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2nd Edition przez Krzysztofa Cwalinę i Brada Abramsa, opublikowane 22 października 2008 przez Addison-Wesley Professional w ramach serii Microsoft Windows Development.

Zobacz także