Sdílet prostřednictvím

Deklarované názvy elementu (Visual Basic)

  • Článek

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í komponenty CLS (Language Independence and Language-Independent Components ), 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.

Řídicí 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 ([ ]). Řídicí název může odpovídat libovolnému klíčovému slovu jazyka Visual Basic, protože hranaté závorky odeberou jakoukoli nejednoznačnost. Hranaté závorky také použijete, když později v kódu odkazujete na název.

Obecně platí, že názvy s řídicími znaky byste měli použít 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á vazbu s rozlišováním velkých a malých písmen. 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 názvem ABCelementu a další sestavení používají vaši třídu prostřednictvím modulu CLR (Common Language Runtime), musí odkazovat na element 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 vydání aktualizované verze sestavení byste neměli měnit abecední případ žádných veřejných prvků.

Názvy a národní prostředí

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é