Visual Basic — Konwencje nazewnictwa

  • Artykuł

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 FindLastRecordRedrawMyForm.

  • Rozpocznij nazwy funkcji i metod z czasownikiem , jak w InitNameArray lub CloseDialog.

  • Rozpocznij nazwy klas, struktury, modułu i właściwości z słowem noun, jak w elem EmployeeName lub CarAccessory.

  • 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ład IPersistable. 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ętrznej Date tylko przez wywołanie metody DateTime.Date.

Zobacz też