Namen deklarierter Elemente (Visual Basic)

  • Artikel

Jedes deklarierte Element weist einen Namen auf, der auch Bezeichner genannt wird und über den der Code darauf verweist.

Regeln

Für Elementnamen in Visual Basic müssen die folgenden Regeln beachtet werden:

  • Er muss mit einem Buchstaben oder einem Unterstrich (_) beginnen.

  • Er darf nur alphabetische Zeichen, Dezimalstellen und Unterstriche enthalten.

  • Er muss mindestens einen Buchstaben oder eine Dezimalziffer enthalten, wenn er mit einem Unterstrich beginnt.

  • Er darf nicht länger als 1.023 Zeichen sein.

Die Längenbegrenzung von 1.023 Zeichen gilt auch für die gesamte Zeichenfolge eines vollqualifizierten Namens, z. B. 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, der zweite beginnt mit einer Dezimalziffer, und der dritte enthält ein ungültiges Zeichen ($).

' Three INVALID element names

_

12ABC

xyz$wv

Achtung

Elementnamen, die mit einem Unterstrich (_) beginnen, sind kein Teil der Sprachenunabhängigkeit und sprachunabhängigen Komponenten (CLS). In CLS-konformem Code dürfen keine Komponenten verwendet werden, die Namen dieser Form definiert. Ein Unterstrich an einer anderen Position in einem Elementnamen ist jedoch CLS-konform.

Richtlinien für die Namenslänge

Aus praktischen Gründen sollte der Name so kurz wie möglich sein, dabei aber gleichzeitig auch die Art des Elements eindeutig identifizieren. Dies verbessert die Lesbarkeit Ihres Codes und reduziert die Zeilenlänge sowie die Größe der Quelldatei.

Andererseits sollte der Name nicht so kurz sein, dass er das Element und dessen Verwendung in Ihrem Code nicht ausreichend beschreibt. Dies ist wichtig für die Lesbarkeit Ihres Codes. Wenn eine andere Person versucht, das Element zu verstehen oder Sie es selbst lange nach dem Schreiben betrachten, können geeignete Elementnamen viel Zeit sparen.

Namen mit Escapezeichen

Im Allgemeinen darf ein Elementname nicht mit einem von Visual Basic reservierten Schlüsselwörter übereinstimmen, z. B. 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 die Klammern auch, wenn Sie weiter unten im Code auf den Namen verweisen.

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

  • Der Code wurde von einer früheren Version von Visual Basic migriert, in der das Schlüsselwort, das als Name verwendet wird; noch nicht reserviert war.

  • 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 hierfür eine einfache Möglichkeit. Weitere Informationen finden Sie unter Refactoring.

Beachtung von Groß-/Kleinschreibung bei Namen

Bei Elementnamen in Visual Basic wird die Groß-/Kleinschreibung nicht beachtet. Dies bedeutet, dass der Compiler beim Vergleich zweier Namen, die sich nur in der Groß-/Kleinschreibung von Buchstaben unterscheiden, diese als denselben Namen interpretiert. Er geht z. B. davon aus, dass ABC und abc auf das gleiche deklarierte Element verweisen.

Allerdings verwendet die Common Language Runtime (CLR) die Groß-/Kleinschreibung unterscheidende Bindung. Wenn Sie also eine Assembly oder DLL erstellen und für andere Assemblys verfügbar machen, wird bei Ihren Namen Groß-und Kleinschreibung unterschieden. Wenn Sie z. B. eine Klasse mit einem Element namens ABCdefinieren, müssen andere Assemblys, die die Klasse über die Common Language Runtime verwenden, auf das Element als ABCverweisen. Wenn Sie die Klasse später erneut kompilieren und den Namen des Elements in abc ändern, können andere Assemblys, die diese Klasse verwenden, nicht mehr auf das Element zugreifen. Wenn Sie also eine aktualisierte Version einer Assembly herausgeben, sollten Sie die Groß-/Kleinschreibung öffentlicher Elemente nicht ändern.

Namen und Gebietsschemas

Der Vergleich von Namen erfolgt unabhängig vom Gebietsschema. Wenn zwei Namen in einem Gebietsschema übereinstimmen, ist garantiert, dass sie in allen Gebietsschemas übereinstimmen.

Siehe auch