Share via

Deklarerade elementnamn (Visual Basic)

  • Artikel

Varje deklarerat element har ett namn, även kallat en identifierare, vilket är vad koden använder för att referera till det.

Regler

Ett elementnamn i Visual Basic måste följa följande regler:

  • Det måste börja med ett alfabetiskt tecken eller ett understreck (_).

  • Den får bara innehålla alfabetiska tecken, decimalsiffror och understreck.

  • Det måste innehålla minst ett alfabetiskt tecken eller decimaltecken om det börjar med ett understreck.

  • Den får inte vara längre än 1 023 tecken.

Längdgränsen på 1 023 tecken gäller även för hela strängen med ett fullständigt kvalificerat namn, till exempel outerNamespace.middleNamespace.innerNamespace.thisClass.thisElement.

I följande exempel visas några giltiga elementnamn.

aB123__45

_567

I följande exempel visas några ogiltiga elementnamn. Den första innehåller bara ett understreck, den andra börjar med en decimalsiffra och den tredje innehåller ett ogiltigt tecken ($).

' Three INVALID element names

_

12ABC

xyz$wv

Varning

Elementnamn som börjar med ett understreck (_) ingår inte i CLS (Language Independence and Language-Independent Components ), så CLS-kompatibel kod kan inte använda en komponent som definierar sådana namn. Ett understreck i en annan position i ett elementnamn är dock CLS-kompatibelt.

Riktlinjer för namnlängd

Som en praktisk fråga bör ditt namn vara så kort som möjligt samtidigt som du tydligt identifierar elementets karaktär. Detta förbättrar kodens läsbarhet och minskar radlängden och källfilens storlek.

Å andra sidan bör ditt namn inte vara så kort att det inte på ett tillfredsställande sätt beskriver vad elementet representerar och hur koden använder det. Detta är viktigt för kodens läsbarhet. Om någon annan försöker förstå det, eller om du själv tittar på det en lång tid efter att du skrev det, kan lämpliga elementnamn spara mycket tid.

Undantagna namn

I allmänhet får ett elementnamn inte matcha något av nyckelorden som reserverats av Visual Basic, till exempel Case eller Friend. Du kan dock definiera ett undantaget namn som omges av hakparenteser ([ ]). Ett undantaget namn kan matcha valfritt Nyckelord i Visual Basic, eftersom hakparenteserna tar bort eventuella tvetydigheter. Du använder också hakparenteserna när du refererar till namnet senare i koden.

I allmänhet bör du endast använda undantagna namn när:

  • Koden har migrerats från en tidigare version av Visual Basic som inte reserverade nyckelordet som används som namn. Eller

  • Du arbetar med kod som skrivits på ett annat språk där det angivna nyckelordet inte är reserverat.

Annars bör du överväga att byta namn på elementet om namnet står i konflikt med ett nyckelord. Den integrerade utvecklingsmiljön (IDE) är ett enkelt sätt att göra detta på. Mer information finns i Omstrukturera.

Skiftlägeskänslighet i namn

Elementnamn i Visual Basic är skiftlägeskänsliga. Det innebär att när kompilatorn jämför två namn som endast skiljer sig åt i alfabetisk ordning tolkas de som samma namn. Den tar till exempel hänsyn ABC till och abc refererar till samma deklarerade element.

Den gemensamma språkkörningen (CLR) använder dock skiftlägeskänslig bindning. När du skapar en sammansättning eller en DLL och gör den tillgänglig för andra sammansättningar är dina namn därför inte längre skiftlägesokänsliga. Om du till exempel definierar en klass med ett element med namnet ABC, och andra sammansättningar använder klassen via den vanliga språkkörningen, måste de referera till elementet som ABC. Om du sedan kompilerar om klassen och ändrar elementets namn till abckan de andra sammansättningarna som använder klassen inte längre komma åt elementet. När du släpper en uppdaterad version av en sammansättning bör du därför inte ändra alfabetiskt skiftläge för offentliga element.

Namn och nationella inställningar

Jämförelsen av namn är oberoende av nationella inställningar. Om två namn matchar i ett språk matchas de garanterat i alla nationella inställningar.

Se även