Sdílet prostřednictvím

Deklarované názvy elementů (Visual Basic)

Každý deklarovaný prvek má název, označovaný také jako identifikátor, což je to, co kód používá k odkaz na něj.

Pravidla

Název elementu v jazyce Visual Basic musí dodržovat následující pravidla:

  • Musí začínat abecedním znakem nebo podtržítkem (_).

  • Musí obsahovat pouze abecední znaky, desítkové číslice a podtržítka.

  • Musí obsahovat alespoň jeden abecední znak nebo desetinnou číslici, pokud začíná podtržítkem.

  • Nesmí být delší než 1023 znaků.

Limit délky 1023 znaků platí také pro celý řetězec plně kvalifikovaného názvu, například outerNamespace.middleNamespace.innerNamespace.thisClass.thisElement.

Následující příklad ukazuje některé platné názvy elementů.

aB123__45

_567

Následující příklad ukazuje některé neplatné názvy elementů. První obsahuje pouze podtržítko, druhá začíná desetinnou číslicí a třetí obsahuje neplatný znak ($).

' Three INVALID element names

_

12ABC

xyz$wv

Upozornění

Názvy elementů začínající podtržítkem (_) nejsou součástí specifikace Nezávislost jazyka a Language-Independent Components (CLS), takže kód kompatibilní se specifikací CLS nemůže použít komponentu, která takové názvy definuje. Podtržítko v libovolné jiné pozici v názvu elementu je však kompatibilní se specifikací CLS.

Pokyny pro délku názvu

V praxi by mělo být vaše jméno co nejkratší a přitom by stále jasně identifikovalo povahu prvku. Tím se zlepší čitelnost kódu a zmenší se délka řádku a velikost zdrojového souboru.

Na druhou stranu by vaše jméno nemělo být tak krátké, že nepopisuje, co prvek představuje a jak ho váš kód používá. To je důležité pro čitelnost kódu. Pokud se ho někdo jiný snaží pochopit, nebo pokud se na něj díváte dlouho po jeho psaní, mohou vhodné názvy prvků ušetřit značné množství času.

Upravené názvy

Obecně platí, že název elementu nesmí odpovídat žádnému z klíčových slov vyhrazených jazykem Visual Basic, například Case nebo Friend. Můžete ale definovat řídicí název, který je uzavřený závorkami ([ ]). Upravený název může odpovídat libovolnému klíčovému slovu jazyka Visual Basic, protože hranaté závorky odstraní veškerou nejednoznačnost. Hranaté závorky také použijete, když později v kódu odkazujete na název.

Obecně byste měli použít escapeované názvy pouze v případě, že:

  • Váš kód se migroval z předchozí verze jazyka Visual Basic, která nezarezervovala klíčové slovo, které se používá jako název; nebo

  • Pracujete s kódem napsaným v jiném jazyce, ve kterém dané klíčové slovo není vyhrazeno.

Jinak byste měli zvážit přejmenování prvku, pokud jeho název koliduje s klíčovým slovem. Integrované vývojové prostředí (IDE) nabízí snadný způsob, jak to udělat. Další informace najdete v tématu Refaktoring.

Citlivost písmen v názvech

Názvy elementů v jazyce Visual Basic nerozlišují malá a velká písmena. To znamená, že když kompilátor porovná dva názvy, které se liší pouze abecedně, interpretuje je jako stejný název. Například považuje ABC a abc odkazuje na stejný deklarovaný prvek.

Modul CLR (common language runtime) však používá případovou citlivost při vazbě. Proto když vytvoříte sestavení nebo knihovnu DLL a zpřístupníte ji jiným sestavením, vaše názvy již nerozlišují malá a velká písmena. Pokud například definujete třídu s prvkem nazvaným ABC, a další sestavení používají vaši třídu prostřednictvím běhového prostředí CLR (Common Language Runtime), musí odkazovat na prvek jako ABC. Pokud následně znovu zkompilujete třídu a změníte název elementu na abc, ostatní sestavení používající vaši třídu již nebudou mít přístup k ho prvku. Proto při uvolnění aktualizované verze sestavení byste neměli měnit velikost písmen žádných veřejných komponent.

Názvy a lokality

Porovnání názvů je nezávislé na národním prostředí. Pokud se dva názvy shodují v jednom národním prostředí, je zaručeno, že se shodují ve všech národních prostředích.

Viz také