Udostępnij za pośrednictwem

Zadeklarowane nazwy elementów (Visual Basic)

Każdy zadeklarowany element ma nazwę, nazywaną również identyfikatorem, którego kod używa do odwoływania się do niego.

Reguły

Nazwa elementu w Visual Basic musi przestrzegać następujących reguł:

  • Musi zaczynać się od znaku alfabetycznego lub podkreślenia (_).

  • Musi zawierać tylko znaki alfabetyczne, cyfry dziesiętne i podkreślenia.

  • Musi zawierać co najmniej jeden znak alfabetyczny lub cyfrę dziesiętną, jeśli zaczyna się od podkreślenia.

  • Długość nie może przekraczać 1023 znaków.

Limit długości 1023 znaków dotyczy również całego ciągu w pełni kwalifikowanej nazwy, na przykład outerNamespace.middleNamespace.innerNamespace.thisClass.thisElement.

W poniższym przykładzie przedstawiono prawidłowe nazwy elementów.

aB123__45

_567

W poniższym przykładzie przedstawiono niektóre nieprawidłowe nazwy elementów. Pierwszy zawiera tylko podkreślenie, drugi zaczyna się cyfrą dziesiętną, a trzeci zawiera nieprawidłowy znak ($).

' Three INVALID element names

_

12ABC

xyz$wv

Ostrzeżenie

Nazwy elementów rozpoczynające się od podkreślenia (_) nie są częścią Language Independence and Language-Independent Components (CLS), więc kod zgodny z CLS nie może używać składnika definiującego takie nazwy. Jednak podkreślenie w dowolnej innej pozycji w nazwie elementu jest zgodne ze specyfikacją CLS.

Wskazówki dotyczące długości nazw

W praktyce imię i nazwisko powinno być możliwie najkrótsze, a jednocześnie wyraźnie zidentyfikować charakter elementu. Poprawia to czytelność kodu i zmniejsza długość wiersza oraz rozmiar pliku źródłowego.

Z drugiej strony nazwa nie powinna być tak krótka, że nie opisuje odpowiednio tego, co reprezentuje element i jak używa go kod. Jest to ważne dla czytelności kodu. Jeśli ktoś inny próbuje to zrozumieć lub jeśli samodzielnie patrzysz na to długo po jego napisaniu, odpowiednie nazwy elementów mogą zaoszczędzić dużo czasu.

Nazwy ucieczki

Ogólnie rzecz biorąc, nazwa elementu nie może być zgodna z żadnym ze słów kluczowych zarezerwowanych przez visual basic, takich jak Case lub Friend. Można jednak zdefiniować nazwę unikniętą, która jest ujęta w nawiasy kwadratowe ([ ]). Nazwa uniknięta może być zgodna z dowolnym słowem kluczowym Języka Visual Basic, ponieważ nawiasy usuwają wszelkie niejednoznaczności. Nawiasy są również używane podczas odwoływania się do nazwy w dalszej części kodu.

Ogólnie rzecz biorąc, należy używać nazw ucieczki tylko wtedy, gdy:

  • Kod został zmigrowany z poprzedniej wersji języka Visual Basic, który nie zarezerwował słowa kluczowego używanego jako nazwa; lub

  • Pracujesz z kodem napisanym w innym języku, w którym podane słowo kluczowe nie jest zastrzeżone.

W przeciwnym razie należy rozważyć zmianę nazwy elementu, jeśli jego nazwa powoduje konflikt ze słowem kluczowym. Zintegrowane środowisko projektowe (IDE) umożliwia łatwe wykonanie tej czynności. Aby uzyskać więcej informacji, zobacz Refaktoryzacja.

Czułość na wielkość liter w nazwach

Nazwy elementów w Visual Basic nie rozróżniają wielkości liter. Oznacza to, że gdy kompilator porównuje dwie nazwy, które różnią się tylko literą alfabetyczną, interpretuje je jako tę samą nazwę. Na przykład interpretuje ABC i abc jako odwołania do tego samego zadeklarowanego elementu.

Jednak środowisko uruchomieniowe języka wspólnego (CLR) używa rozróżniania wielkości liter. W związku z tym, gdy tworzysz zestaw lub bibliotekę DLL i udostępniasz ją innym zestawom, nazwy nie są już traktowane jako nie rozróżniające wielkości liter. Jeśli na przykład zdefiniujesz klasę z elementem o nazwie ABC, a inne zestawy używają klasy za pośrednictwem środowiska uruchomieniowego języka wspólnego, muszą one odwoływać się do elementu jako ABC. Jeśli następnie ponownie skompilujesz klasę i zmienisz nazwę elementu na abc, inne zestawy używające klasy nie będą już mogły uzyskać dostępu do tego elementu. W związku z tym po wydaniu zaktualizowanej wersji zestawu nie należy zmieniać wielkości liter alfabetycznych żadnych elementów publicznych.

Nazwy i ustawienia regionalne

Porównanie nazw jest niezależne od ustawień regionalnych. Jeśli dwie nazwy są zgodne w jednym regionie, będą zgodne we wszystkich regionach.

Zobacz także