Verwaltung der C#-Sprachversion
Der C#-Compiler bestimmt eine Standardsprachversion, die auf den Zielframeworks Ihres Projekts basiert. In Visual Studio gibt es keine Benutzeroberfläche zum Ändern dieses Werts, aber Sie können ihn ändern, indem Sie die CSPROJ-Datei bearbeiten. Mit der Auswahl des Standardwerts wird sichergestellt, dass Sie die neueste Sprachversion nutzen, die mit Ihrem Zielframework kompatibel ist. So profitieren Sie vom Zugriff auf die neuesten Sprachfeatures, die mit dem Zielframework Ihres Projekts kompatibel sind. Mit dem Standardwert wird außerdem sichergestellt, dass Sie keine Sprache verwenden, die Typen oder Runtimeverhalten erfordert, die nicht im Zielframework verfügbar sind. Wenn Sie eine Sprachversion auswählen, die neuer als die Standardeinstellung ist, können Kompilierzeit- und Runtimefehler auftreten, die schwer zu diagnostizieren sind.
C# 12 wird nur in .NET 8 und höher unterstützt. C# 11 wird nur in .NET 7 und höher unterstützt. C# 10 wird nur in .NET 6 und höher unterstützt.
Auf der Seite Visual Studio-Plattformkompatibilität finden Sie Details dazu, welche .NET-Versionen von Versionen von Visual Studio unterstützt werden. Weitere Informationen dazu, welche .NET-Versionen von Versionen von Visual Studio für Mac unterstützt werden, finden Sie auf der Seite Visual Studio für Mac-Plattformkompatibiliät. Überprüfen Sie die Mono-Seite für C#, um mehr über die Mono-Kompatibilität mit C#-Versionen zu erfahren.
der Arbeitszeittabelle
Der Compiler bestimmt basierend auf den folgenden Regeln eine Standardversion:
Ziel | Version | C#-Sprachversionsstandard |
---|---|---|
.NET | 8.x | C# 12 |
.NET | 7.x | C# 11 |
.NET | 6.x | C# 10 |
.NET | 5.x | C# 9.0 |
.NET Core | 3.x | C# 8.0 |
.NET Core | 2.x | C# 7.3 |
.NET-Standard | 2.1 | C# 8.0 |
.NET-Standard | 2.0 | C# 7.3 |
.NET-Standard | 1.x | C# 7.3 |
.NET Framework | alle | C# 7.3 |
Wenn Ihr Projekt auf ein preview
-Framework abzielt, das eine entsprechende Vorschausprachversion hat, wird die Vorschausprachversion als Sprachversion verwendet. In dieser Vorschau können Sie die neuesten Features in beliebigen Umgebungen verwenden, ohne Auswirkungen auf Projekte für eine veröffentlichte .NET Core-Version zu haben.
Wichtig
Die neue Projektvorlage für Visual Studio 2017 hat einen <LangVersion>latest</LangVersion>
-Eintrag zu neuen Projektdateien hinzugefügt. Wenn Sie das Zielframework für diese Projekte aktualisieren, kann die <LangVersion>
-Einstellung den Standardwert für das neue Zielframework außer Kraft setzen. Entfernen Sie unbedingt <LangVersion>latest</LangVersion>
aus der Projektdatei, um sicherzustellen, dass Ihr Projekt die empfohlene Compilerversion für Ihr Zielframework verwendet. Sie können das Zielframework aktualisieren, um auf neuere Sprachfeatures zuzugreifen.
Außerkraftsetzung des Standardwerts
Wenn Sie Ihre C#-Version explizit angeben müssen, haben Sie verschiedene Möglichkeiten:
- Manuelles Bearbeiten der Projektdatei
- Festlegen der Sprachversion für mehrere Projekte in einem Unterverzeichnis
- Konfigurieren Sie die LangVersion-Compileroption.
Tipp
Die Sprachversion in Visual Studio wird auf der Projekteigenschaftenseite angezeigt. Auf der Registerkarte Build wird im Bereich Erweitert die ausgewählte Version angezeigt.
Wenn Sie wissen möchten, welche Sprachversion Sie derzeit verwenden, fügen Sie #error version
(Groß-/Kleinschreibung beachten) in Ihren Code ein. Dadurch meldet der Compiler einen Compilerfehler (CS8304) mit einer Meldung, die die verwendete Compilerversion und die zurzeit ausgewählte Sprachversion enthält. Weitere Informationen finden Sie unter #error (C#-Referenz).
Bearbeiten der Projektdatei
Sie können die Sprachversion in der Projektdatei festlegen. Wenn Sie beispielsweise expliziten Zugriff auf Previewfunktionen wünschen, fügen Sie ein Element wie folgt hinzu:
<PropertyGroup>
<LangVersion>preview</LangVersion>
</PropertyGroup>
Der Wert preview
verwendet die neueste verfügbare Vorschauversion der Sprache C#, die Ihr Compiler unterstützt.
Konfigurieren mehrerer Projekte
Zum Konfigurieren mehrerer Projekte können Sie eine Datei vom Typ Directory.Build.props erstellen, die sich normalerweise in Ihrem Projektmappenverzeichnis befindet und das Element <LangVersion>
enthält. Fügen Sie der Datei Directory.Build.props die folgende Einstellung hinzu:
<Project>
<PropertyGroup>
<LangVersion>preview</LangVersion>
</PropertyGroup>
</Project>
Builds in allen Unterverzeichnissen des Verzeichnisses, das diese Datei enthält, verwenden nun die C#-Vorschauversion. Weitere Informationen finden Sie unter Anpassen des Builds.
Referenz zur C#-Sprachversion
In der folgenden Tabelle sind alle aktuellen C#-Sprachversionen enthalten. Ältere Compiler verstehen möglicherweise nicht jeden Wert. Wenn Sie das neueste .NET SDK installieren, erhalten Sie Zugriff auf alle aufgelisteten Syntaxversionen.
Wert | Bedeutung |
---|---|
preview |
Der Compiler akzeptiert jede gültige Sprachsyntax der letzten Vorschauversion. |
latest |
Der Compiler akzeptiert die Syntax der neuesten veröffentlichte Version des Compilers (einschließlich Nebenversionen). |
latestMajor oder default |
Der Compiler akzeptiert die Syntax der neuesten veröffentlichte Hauptversion des Compilers. |
12.0 |
Der Compiler akzeptiert nur Syntax von C# 12 oder niedriger. |
11.0 |
Der Compiler akzeptiert nur Syntax von C# 11 oder niedriger. |
10.0 |
Der Compiler akzeptiert nur Syntax, die in C# 10 oder niedriger enthalten ist. |
9.0 |
Der Compiler akzeptiert nur Syntax, die in C# 9 oder niedriger enthalten ist. |
8.0 |
Der Compiler akzeptiert nur Syntax, die in C# 8.0 oder niedriger enthalten ist. |
7.3 |
Der Compiler akzeptiert nur Syntax, die in C# 7.3 oder früher enthalten ist. |
7.2 |
Der Compiler akzeptiert nur Syntax, die in C# 7.2 oder früher enthalten ist. |
7.1 |
Der Compiler akzeptiert nur Syntax, die in C# 7.1 oder früher enthalten ist. |
7 |
Der Compiler akzeptiert nur Syntax, die in C# 7.0 oder früher enthalten ist. |
6 |
Der Compiler akzeptiert nur Syntax, die in C# 6.0 oder früher enthalten ist. |
5 |
Der Compiler akzeptiert nur Syntax, die in C# 5.0 oder früher enthalten ist. |
4 |
Der Compiler akzeptiert nur Syntax, die in C# 4.0 oder früher enthalten ist. |
3 |
Der Compiler akzeptiert nur Syntax, die in C# 3.0 oder früher enthalten ist. |
ISO-2 oder 2 |
Der Compiler akzeptiert nur Syntax, die in ISO/IEC 23270:2006 C# (2.0) enthalten ist. |
ISO-1 oder 1 |
Der Compiler akzeptiert nur Syntax, die in ISO/IEC 23270:2003 C# (1.0/1.2) enthalten ist. |
Hinweis
Die Angabe von LangVersion mit dem Wert default
entspricht nicht dem Weglassen der Option LangVersion. Bei der Angabe von default
wird die neueste Version der Sprache verwendet, die der Compiler unterstützt, ohne das Zielframework zu berücksichtigen. Beispielsweise wird beim Erstellen eines Projekts für .NET 6 über die aktuelle Version von Visual Studio 2022 C# 10 verwendet, wenn LangVersion nicht angegeben ist. Wenn LangVersion auf default
festgelegt ist, wird hingegen C# 12 verwendet.
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für