Visual Basic — Konwencje nazewnictwa
Podczas nadawania nazwy elementu w aplikacji Visual Basic pierwszy znak tej nazwy musi być znakiem alfabetycznym lub podkreślenia. Należy jednak pamiętać, że nazwy rozpoczynające się od podkreślenia nie są zgodne ze składnikami Language Independence i Language-Independent Components (CLS).
Poniższe sugestie dotyczą nazewnictwa.
Początek każdego oddzielnego wyrazu w nazwie z literą wielkich liter, jak w i
FindLastRecord
RedrawMyForm
.Rozpocznij nazwy funkcji i metod z czasownikiem , jak w
InitNameArray
lubCloseDialog
.Rozpocznij nazwy klas, struktury, modułu i właściwości z słowem noun, jak w elem
EmployeeName
lubCarAccessory
.Rozpocznij nazwy interfejsów z prefiksem "I", po którym następuje cioł lub fraza ciołowa, na przykład
IComponent
, lub przymiotnik opisujący zachowanie interfejsu, na przykładIPersistable
. Nie używaj podkreślenia i używaj skrótów oszczędnie, ponieważ skróty mogą powodować zamieszanie.Rozpocznij nazwy programu obsługi zdarzeń z nounem opisującym typ zdarzenia, po którym następuje sufiks "
EventHandler
", jak w ciągu "MouseEventHandler
".W nazwach klas argumentów zdarzeń dołącz sufiks "
EventArgs
".Jeśli zdarzenie ma pojęcie "przed" lub "po", użyj sufiksu w czasie obecnym lub przeszłym, jak w "
ControlAdd
" lub "ControlAdded
".W przypadku długich lub często używanych terminów użyj skrótów, aby zachować rozsądne długości nazw, na przykład "HTML", zamiast "Hypertext Markup Language". Ogólnie rzecz biorąc, nazwy zmiennych większe niż 32 znaki są trudne do odczytania na monitorze ustawionym na niską rozdzielczość. Upewnij się również, że skróty są spójne w całej aplikacji. Losowe przełączanie w projekcie między językiem "HTML" i "Hypertext Markup Language" może prowadzić do nieporozumień.
Unikaj używania nazw w zakresie wewnętrznym, które są takie same jak nazwy w zakresie zewnętrznym. Błędy mogą spowodować uzyskanie dostępu do nieprawidłowej zmiennej. Jeśli występuje konflikt między zmienną a słowem kluczowym o tej samej nazwie, musisz zidentyfikować słowo kluczowe, poprzedzając je odpowiednią biblioteką typów. Jeśli na przykład masz zmienną o nazwie
Date
, możesz użyć funkcji wewnętrznejDate
tylko przez wywołanie metody DateTime.Date.