/checked (C#-Compileroptionen)

Die Option /checked gibt an, ob eine Ganzzahlarithmetikanweisung, die zu einem Wert führt, der nicht im Bereich des Datentyps ist und der nicht im Gültigkeitsbereich eines checked-Schlüsselworts bzw. unchecked-Schlüsselworts ist, eine Laufzeitausnahme auslöst.

/checked[+ | -]

Hinweise

Eine Ganzzahlarithmetikanweisung, die sich im Gültigkeitsbereich der Schlüsselwörter checked oder unchecked befindet, wird durch die Option /checked nicht beeinflusst.

Ergibt eine Ganzzahlarithmetikanweisung, die sich nicht im Gültigkeitsbereich der Schlüsselwörter checked oder unchecked befindet, einen Wert außerhalb des Datentypbereichs, und wird bei der Kompilierung /checked+ (/checked) verwendet, generiert diese Anweisung eine Ausnahme zur Laufzeit. Wenn /checked- bei der Kompilierung verwendet wird, verursacht diese Anweisung keine Ausnahme zur Laufzeit.

Der Standardwert für diese Option ist /checked-. Ein Szenario für die Verwendung von /checked- ist, wenn große Anwendungen erstellt werden. Manchmal werden automatisierte Tools verwendet, um solche Anwendungen zu erstellen, und solch ein Tool legt möglicherweise automatisch /checked auf + fest. Sie können den globalen Standard des Tools überschreiben, indem Sie /checked- angeben.

So legen Sie diese Compileroption in der Visual Studio-Entwicklungsumgebung fest

  1. Öffnen Sie die Eigenschaften-Seite des Projekts. Weitere Informationen finden Sie unter Seite "Erstellen", Projekt-Designer (C#).

  2. Klicken Sie auf die Eigenschaftenseite Erstellen.

  3. Klicken Sie auf die Schaltfläche Erweitert.

  4. Ändern Sie die Eigenschaft Auf arithmetischen Über-/Unterlauf überprüfen.

Weitere Informationen zum programmgesteuerten Zugriff auf diese Compileroption finden Sie unter CheckForOverflowUnderflow.

Beispiel

Der folgende Befehl kompiliert t2.cs. Die Verwendung von /checked im Befehl gibt an, dass jede ganzzahlige arithmetische Anweisung in der Datei, die nicht im Bereich eines checked- oder unchecked-Schlüsselworts ist, und die einen Wert ergibt, der außerhalb des Bereichs des Datentyps ist, zur Laufzeit eine Ausnahme auslöst.

csc t2.cs /checked

Siehe auch

Konzepte

Einführung in den Projekt-Designer

Weitere Ressourcen

C#-Compileroptionen

Projekteigenschaften (Visual Studio)