Zadeklarowane nazwy elementów (Visual Basic)

  • Artykuł

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

Uwaga

Nazwy elementów rozpoczynające się od podkreślenia (_) nie są częścią elementów Language Independence and Language-Independent Components (CLS), więc kod zgodny ze specyfikacją 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.

Ważność wielkości liter w nazwach

Nazwy elementów w Visual Basic są bez uwzględniania 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 rozważa ABC i abc odwołuje się do tego samego zadeklarowanego elementu.

Jednak środowisko uruchomieniowe języka wspólnego (CLR) używa powiązania z uwzględnieniem wielkości liter. W związku z tym podczas tworzenia zestawu lub biblioteki DLL i udostępniania jej innym zestawom nazwy nie są już bez uwzględniania 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 z jednymi ustawieniami regionalnymi, są one gwarantowane do dopasowania we wszystkich ustawieniach regionalnych.

Zobacz też