Option Explicit-Anweisung (Visual Basic)

Artikel
09/03/2008

Aktualisiert: November 2007

Erzwingt die explizite Deklaration aller Variablen in einer Datei.

Option Explicit { On | Off }

Bestandteile

On
Optional. Aktiviert die Option Explicit-Überprüfung. Wenn weder On noch Off angegeben ist, lautet der Standardwert On.
Off
Optional. Deaktiviert die Option Explicit-Überprüfung.

Hinweise

Bei Verwendung der Option Explicit-Anweisung muss diese in einer Datei vor allen anderen Quellcodeanweisungen angeordnet sein.

Wenn Option Explicit in einer Datei angegeben wird, müssen alle Variablen explizit mit der Dim-Anweisung oder der ReDim-Anweisung deklariert werden. Wenn Sie einen nicht deklarierten Variablennamen verwenden, tritt ein Fehler beim Kompilieren auf.

Mit Option Explicit vermeiden Sie falsch geschriebene Namen bereits vorhandener Variablen oder Verwechslungen im Code bei unklarem Gültigkeitsbereich von Variablen. Wenn Sie die Option Explicit-Anweisung nicht verwenden, sind alle nicht deklarierten Variablen vom Typ Object.

Hinweis:
Der Compilerstandardwert ist Option Explicit On, sofern Sie nicht Option Explicit im Code angeben.

Sie können Option Explicit auch in der integrierten Entwicklungsumgebung (IDE, Integrated Development Environment) von Visual Studio oder in einer Befehlszeile festlegen.

Hinweis:
Die angezeigten Dialogfelder und Menübefehle können sich je nach den aktiven Einstellungen oder der verwendeten Version von den in der Hilfe beschriebenen unterscheiden. Klicken Sie im Menü Extras auf Einstellungen importieren und exportieren, um die Einstellungen zu ändern. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

So legen Sie Option Explicit in der IDE fest

Klicken Sie im Menü Extras auf Optionen.
Öffnen Sie den Knoten Projekte und Projektmappen.
Wählen Sie VB-Standard aus.
Ändern Sie die Einstellung Option Explicit.

So legen Sie Option Explicit in der Befehlszeile fest

Fügen Sie die /optionexplicit-Compileroption in den vbc-Befehl ein.

Beispiel

Im folgenden Beispiel wird die Option Explicit-Anweisung verwendet, um die explizite Deklaration aller Variablen zu erzwingen. Wenn Sie eine nicht deklarierte Variable verwenden, tritt ein Fehler beim Kompilieren auf.

' Force explicit variable declaration.
Option Explicit On

Dim thisVar As Integer
thisVar = 10
' The following assignment produces a COMPILER ERROR because
' the variable is not declared and Option Explicit is On.
thisInt = 10 ' causes ERROR