/define (C#-Compileroptionen)
Die Option /define definiert name als Symbol in allen Quellcodedateien Ihres Programms.
/define:name[;name2]
Argumente
- name, name2
Der Name eines oder mehrerer Symbole, die Sie definieren möchten.
Hinweise
Die Option /define hat dieselbe Auswirkung wie die Verwendung eines #define-Präprozessordirektiven, außer dass die Compileroption für alle Dateien im Projekt gültig ist. Ein Symbol bleibt in einer Quelldatei definiert, bis eine #undef-Direktive in der Quelldatei die Definition entfernt. Wenn Sie die Option /define verwenden, hat eine #undef-Direktive in einer Datei keinerlei Auswirkung auf andere Quellcodedateien im Projekt.
Sie können die durch diese Option erstellten Symbole in Verbindung mit #if, #else, #elif und #endif verwenden, um Quelldateien bedingt zu kompilieren.
/d ist die Kurzform von /define.
Sie können mehrere Symbole mit /define definieren, indem Sie die Symbolnamen jeweils durch ein Semikolon oder Komma voneinander trennen. Beispiele:
/define:DEBUG;TUESDAY
Der C# -Compiler selbst definiert keine Symbole oder Makros, die Sie im Quellcode verwenden können. Alle Symboldefinitionen müssen benutzerdefiniert sein.
Tipp
Anders als in Programmiersprachen wie C++ ist es in C# bei Verwendung von #define nicht zulässig, einem Symbol einen Wert zuzuweisen. Beispielsweise kann #define nicht zum Erstellen eines Makros oder zum Definieren einer Konstante verwendet werden. Falls Sie eine Konstante definieren müssen, verwenden Sie eine enum-Variable. Wenn Sie ein C++-übliches Makro erstellen möchten, erwägen Sie Alternativen wie Generika. Da Makros sehr fehleranfällig sind, ist ihre Verwendung in C# nicht zugelassen. Es stehen jedoch sicherere Alternativen zur Verfügung.
So legen Sie diese Compileroption in der Visual Studio-Entwicklungsumgebung fest
Öffnen Sie die Eigenschaften-Seite des Projekts.
Geben Sie auf der Registerkarte Erstellen im Feld Symbole für bedingte Kompilierung das zu definierende Symbol ein. Wenn Sie z. B. das folgende Codebeispiel verwenden, geben Sie im Textfeld einfach xx ein.
Informationen zum programmgesteuerten Festlegen dieser Compileroption finden Sie unter DefineConstants.
Beispiel
// preprocessor_define.cs
// compile with: /define:xx
// or uncomment the next line
// #define xx
using System;
public class Test
{
public static void Main()
{
#if (xx)
Console.WriteLine("xx defined");
#else
Console.WriteLine("xx not defined");
#endif
}
}