Freigeben über

Deklarierte Elementnamen (Visual Basic)

Jedes deklarierte Element hat einen Namen, auch als Bezeichner bezeichnet, was der Code verwendet, um darauf zu verweisen.

Regeln

Ein Elementname in Visual Basic muss die folgenden Regeln beachten:

  • Sie muss mit einem alphabetischen Zeichen oder einem Unterstrich (_) beginnen.

  • Sie darf nur alphabetische Zeichen, Dezimalziffern und Unterstriche enthalten.

  • Sie muss mindestens ein alphabetisches Zeichen oder eine Dezimalziffer enthalten, wenn sie mit einem Unterstrich beginnt.

  • Er darf maximal 1023 Zeichen lang sein.

Die Längenbeschränkung von 1023 Zeichen gilt auch für die gesamte Zeichenfolge eines vollqualifizierten Namens, wie zum Beispiel outerNamespace.middleNamespace.innerNamespace.thisClass.thisElement.

Das folgende Beispiel zeigt einige gültige Elementnamen.

aB123__45

_567

Das folgende Beispiel zeigt einige ungültige Elementnamen. Der erste enthält nur einen Unterstrich, die zweite beginnt mit einer Dezimalziffer, und das dritte enthält ein ungültiges Zeichen ($).

' Three INVALID element names

_

12ABC

xyz$wv

Vorsicht

Elementnamen, die mit einem Unterstrich (_) beginnen, sind nicht Teil der Language Independence and Language-Independent Components (CLS), sodass CLS-kompatibler Code keine Komponente verwenden kann, die solche Namen definiert. Ein Unterstrich an einer anderen Position in einem Elementnamen ist jedoch CLS-kompatibel.

Richtlinien für die Namenslänge

In der Praxis sollte Ihr Name so kurz wie möglich sein und gleichzeitig die Art des Elements eindeutig identifizieren. Dadurch wird die Lesbarkeit des Codes verbessert und die Zeilenlänge und die Quelldateigröße reduziert.

Auf der anderen Seite sollte Ihr Name nicht so kurz sein, dass er nicht angemessen beschreibt, was das Element darstellt und wie ihr Code es verwendet. Dies ist wichtig für die Lesbarkeit ihres Codes. Wenn jemand anderes versucht, es zu verstehen, oder wenn Sie es zu einem späteren Zeitpunkt, lange nachdem Sie es geschrieben haben, betrachten, können geeignete Elementnamen erheblich Zeit sparen.

Namen mit Escapezeichen

Im Allgemeinen darf ein Elementname keinem der von Visual Basic reservierten Schlüsselwörter entsprechen, wie Case oder Friend. Sie können jedoch einen Namen mit Escapezeichen definieren, indem Sie ihn in Klammern ([ ]) einschließen. Ein Name mit Escapezeichen kann mit jedem Visual Basic-Schlüsselwort übereinstimmen, da durch die Klammern jegliche Mehrdeutigkeit entfällt. Sie verwenden auch die Klammern, wenn Sie später im Code auf den Namen verweisen.

Im Allgemeinen sollten Sie Namen mit Escapezeichen nur in folgenden Fällen verwenden:

  • Ihr Code wurde aus einer früheren Version von Visual Basic migriert, die das Schlüsselwort, das als Name verwendet wird, nicht reserviert hat. oder

  • Sie arbeiten mit Code, der in einer anderen Sprache geschrieben wurde, in der das angegebene Schlüsselwort nicht reserviert ist.

Andernfalls sollten Sie erwägen, das Element umzubenennen, wenn der Name mit einem Schlüsselwort in Konflikt steht. Die integrierte Entwicklungsumgebung (Integrated Development Environment, IDE) bietet eine einfache Möglichkeit, dies zu tun. Weitere Informationen finden Sie unter "Umgestaltung".

Beachtung von Groß-/Kleinschreibung bei Namen

Bei Elementnamen in Visual Basic wird die Groß-/Kleinschreibung nicht beachtet. Dies bedeutet: Wenn der Compiler zwei Namen vergleicht, die sich nur in alphabetischer Groß-/Kleinschreibung unterscheiden, interpretiert er sie als denselben Namen. Beispielsweise wird angenommen, dass ABC und abc sich auf dasselbe deklarierte Element beziehen.

Die Common Language Runtime (CLR) verwendet jedoch eine case-sensitive Bindung. Wenn Sie also eine Assembly oder eine DLL erstellen und sie für andere Assemblys verfügbar machen, sind Ihre Namen nicht mehr case-insensitive. Wenn Sie beispielsweise eine Klasse mit einem Element namens ABCdefinieren und andere Assemblys Ihre Klasse über die Common Language Runtime verwenden, müssen sie auf das Element verweisen als ABC. Wenn Sie die Klasse anschließend neu kompilieren und den Namen des Elements in abc ändern, könnten die anderen Assemblys, die Ihre Klasse verwenden, nicht mehr auf dieses Element zugreifen. Wenn Sie also eine aktualisierte Version einer Assembly freigeben, sollten Sie den alphabetischen Fall aller öffentlichen Elemente nicht ändern.

Namen und Gebietsschemas

Der Vergleich von Namen ist nicht abhängig von der Region. Wenn zwei Namen in einem Gebietsschema übereinstimmen, ist garantiert, dass sie in allen Gebietsschemas übereinstimmen.

Siehe auch