Delen via


Gedeclareerde elementnamen (Visual Basic)

Elk gedeclareerd element heeft een naam, ook wel een id genoemd. Dit is wat de code gebruikt om ernaar te verwijzen.

Regels

Een elementnaam in Visual Basic moet voldoen aan de volgende regels:

  • Het moet beginnen met een alfabetisch teken of een onderstrepingsteken (_).

  • Deze mag alleen alfabetische tekens, decimale cijfers en onderstrepingstekens bevatten.

  • Het moet ten minste één alfabetisch teken of een decimaal cijfer bevatten als het begint met een onderstrepingsteken.

  • Het mag niet langer zijn dan 1023 tekens.

De lengtelimiet van 1023 tekens is ook van toepassing op de hele tekenreeks van een volledig gekwalificeerde naam, zoals outerNamespace.middleNamespace.innerNamespace.thisClass.thisElement.

In het volgende voorbeeld ziet u enkele geldige elementnamen.

aB123__45

_567

In het volgende voorbeeld ziet u enkele ongeldige elementnamen. De eerste bevat alleen een onderstrepingsteken, de tweede begint met een decimaalteken en de derde bevat een ongeldig teken ($).

' Three INVALID element names

_

12ABC

xyz$wv

Let op

Elementnamen die beginnen met een onderstrepingsteken (_) maken geen deel uit van de CLS (Language Independence and Language-Independent Components ), dus cls-compatibele code kan geen onderdeel gebruiken dat dergelijke namen definieert. Een onderstrepingsteken in een andere positie in een elementnaam is echter CLS-compatibel.

Richtlijnen voor naamlengte

In de praktijk moet uw naam zo kort mogelijk zijn, terwijl u de aard van het element nog steeds duidelijk identificeert. Dit verbetert de leesbaarheid van uw code en vermindert de regellengte en de grootte van het bronbestand.

Aan de andere kant mag uw naam niet zo kort zijn dat het niet voldoende beschrijft wat het element vertegenwoordigt en hoe uw code deze gebruikt. Dit is belangrijk voor de leesbaarheid van uw code. Als iemand anders het probeert te begrijpen, of als u er lang naar kijkt nadat u het hebt geschreven, kunnen geschikte elementnamen een aanzienlijke hoeveelheid tijd besparen.

Namen met escape-tekens

Over het algemeen mag een elementnaam niet overeenkomen met een van de trefwoorden die zijn gereserveerd door Visual Basic, zoals Case of Friend. U kunt echter een escaped-naam definiëren, die tussen vierkante haken ([ ]) staat. Een escape-naam kan overeenkomen met elk Visual Basic-trefwoord, omdat de haakjes eventuele dubbelzinnigheid verwijderen. U gebruikt ook de vierkante haken wanneer u verderop in uw code naar de naam verwijst.

Over het algemeen moet u alleen escape-namen gebruiken wanneer:

  • Uw code is gemigreerd van een eerdere versie van Visual Basic die het trefwoord dat wordt gebruikt als een naam niet heeft gereserveerd; Of

  • U werkt met code die is geschreven in een andere taal waarin het opgegeven trefwoord niet is gereserveerd.

Anders moet u overwegen de naam van het element te wijzigen als de naam van het element conflicteert met een trefwoord. De IDE (Integrated Development Environment) biedt een eenvoudige manier om dit te doen. Zie Herstructurering voor meer informatie.

Hoofdlettergevoeligheid in namen

Elementnamen in Visual Basic zijn hoofdlettergevoelig. Dit betekent dat wanneer de compiler twee namen vergelijkt die alleen in alfabetische letters verschillen, ze als dezelfde naam worden geïnterpreteerd. Het is bijvoorbeeld van mening dat hetzelfde gedeclareerde element wordt beschouwd ABC en abc verwijst naar hetzelfde gedeclareerde element.

De Common Language Runtime (CLR) maakt echter gebruik van hoofdlettergevoelige binding. Als u daarom een assembly of DLL produceert en deze beschikbaar maakt voor andere assembly's, zijn uw namen niet langer hoofdlettergevoelig. Als u bijvoorbeeld een klasse definieert met een element dat wordt aangeroepen ABCen andere assembly's gebruikmaken van uw klasse via de algemene taalruntime, moeten ze verwijzen naar het element als ABC. Als u de klasse vervolgens opnieuw compileert en de naam abcvan het element wijzigt in, hebben de andere assembly's met uw klasse geen toegang meer tot dat element. Wanneer u een bijgewerkte versie van een assembly vrijgeeft, moet u daarom het alfabetische geval van openbare elementen niet wijzigen.

Namen en landinstellingen

Vergelijking van namen is onafhankelijk van landinstellingen. Als twee namen in één landinstelling overeenkomen, komen ze gegarandeerd overeen in alle landinstellingen.

Zie ook