{"id":21967,"date":"2019-02-27T11:59:23","date_gmt":"2019-02-27T18:59:23","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/dotnet\/?p=21967"},"modified":"2019-04-12T12:41:18","modified_gmt":"2019-04-12T19:41:18","slug":"an-update-to-c-versions-and-c-tooling","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/dotnet\/an-update-to-c-versions-and-c-tooling\/","title":{"rendered":"An update to C# versions and C# tooling"},"content":{"rendered":"

Starting with Visual Studio 2019 Preview 4 and RC, we’ll be adjusting how C# versions are treated in .NET tooling. The version of C# used by your project will now be determined by target framework.<\/p>\n

Summary of changes<\/h2>\n

The most important change is that the version of C# used by tooling by default will be determined by the target framework of your project.<\/p>\n

Additionally, we are adding two new Language Version (LangVer) values: LatestMajor<\/strong> and Preview<\/strong>. Here\u2019s how they stack up compared with the currently supported list of values:<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
LangVersion<\/th>\nMeaning<\/th>\n<\/tr>\n<\/thead>\n
ISO-1<\/td>\nC# 1.0\/1.2<\/td>\n<\/tr>\n
ISO-2<\/td>\nC# 2.0<\/td>\n<\/tr>\n
3<\/td>\nC# 3.0<\/td>\n<\/tr>\n
4<\/td>\nC# 4.0<\/td>\n<\/tr>\n
5<\/td>\nC# 5.0<\/td>\n<\/tr>\n
6<\/td>\nC# 6.0<\/td>\n<\/tr>\n
7<\/td>\nC# 7.0<\/td>\n<\/tr>\n
7.1<\/td>\nC# 7.1<\/td>\n<\/tr>\n
7.2<\/td>\nC# 7.2<\/td>\n<\/tr>\n
7.3<\/td>\nC# 7.3<\/td>\n<\/tr>\n
8.0<\/td>\nC# 8.0<\/td>\n<\/tr>\n
LatestMajor<\/td>\nLatest supported major C# language version<\/td>\n<\/tr>\n
Preview<\/td>\nLatest available preview C# language version<\/td>\n<\/tr>\n
Latest<\/td>\nLatest supported C# language version (including minor version)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

 <\/p>\n

The meaning of \u201csupported C# language version\u201d differs based on target, and the default used is also determined by the target of your project.<\/p>\n

How this works for .NET Core 3.0 and .NET Standard 2.1<\/h2>\n

C# 8.0 has been built with .NET Core 3.0 and .NET Standard 2.1 in mind. Many of its features only work on .NET Core 3.0. This means .NET Core 3.0 and .NET Standard 2.1 are the only .NET Core and .NET Standard versions where C# 8.0 is supported.<\/p>\n

How this works for all other target frameworks<\/h2>\n

Because C# 8.0 has been built for .NET Core 3.0 and .NET Standard 2.1, it will not be supported outside of .NET Core 3.0 and any platform implementing .NET Standard 2.1.<\/p>\n

Support and compatibility for preview features<\/h2>\n

This change means that C# 8.0 preview will be the default for .NET Core 3.0 preview in all .NET tools, including Visual Studio. The way to think about support in this world is slightly different than before. We distinguish support today along the following lines:<\/p>\n

    \n
  • Any C# 7.3 and lower feature or behavior is fully supported and fully compatible in any context (.NET Core 3.0, .NET Core 2.x, .NET Framework, etc.). No change from what exists today.<\/li>\n
  • Any C# preview feature is unsupported.<\/li>\n
  • There is no compatibility guarantee from one C# preview to another.<\/li>\n<\/ul>\n

    In short, if you use C# 8.0 preview with Visual Studio 2019, some features and behaviors may change between now and when C# 8.0 fully releases.<\/p>\n

    Happy hacking!<\/p>\n","protected":false},"excerpt":{"rendered":"

    Starting with Visual Studio 2019 Preview 4, we’ll be adjusting how C# versions are treated in .NET tooling. Firstly, we’re adding two new Language Version (LangVersion) values: LatestMajor and Preview. Rad the post to see how they stack up with the currently supported list of values. <\/p>\n","protected":false},"author":678,"featured_media":58792,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[685,196,756],"tags":[9,30,46],"class_list":["post-21967","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-dotnet","category-dotnet-core","category-csharp","tag-net-core","tag-announcement","tag-c"],"acf":[],"blog_post_summary":"

    Starting with Visual Studio 2019 Preview 4, we’ll be adjusting how C# versions are treated in .NET tooling. Firstly, we’re adding two new Language Version (LangVersion) values: LatestMajor and Preview. Rad the post to see how they stack up with the currently supported list of values. <\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts\/21967","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/users\/678"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/comments?post=21967"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts\/21967\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/media\/58792"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/media?parent=21967"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/categories?post=21967"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/tags?post=21967"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}