|
1 | 1 | ## C# for Visual Studio Code
|
2 |
| -A [Visual Studio Code](https://code.visualstudio.com/) [extension](https://marketplace.visualstudio.com/VSCode) that provides rich language support for C# and is shipped as part of [C# Dev Kit][csdevkitextension]. |
3 |
| - |
4 |
| -This pre-release version of the extension is available for use today, and offers performant and reliable support for coding in C#. Powered by a Language Server Protocol (LSP) Tools Host, this extension integrates with open source components like [Roslyn](https://github.com/dotnet/roslyn) and [Razor](https://github.com/dotnet/razor) to provide rich type information and a faster, more reliable C# experience. |
| 2 | +A [Visual Studio Code](https://code.visualstudio.com/) [extension](https://marketplace.visualstudio.com/VSCode) that provides rich language support for C# and is shipped as part of [C# Dev Kit][csdevkitextension]. Powered by a Language Server Protocol (LSP) server, this extension integrates with open source components like [Roslyn](https://github.com/dotnet/roslyn) and [Razor](https://github.com/dotnet/razor) to provide rich type information and a faster, more reliable C# experience. |
5 | 3 |
|
6 | 4 | ## Recommended Install
|
7 | 5 | While it is possible to use the C# extension as a standalone extension, we highly recommend using [C# Dev Kit][csdevkitextension].
|
8 | 6 |
|
9 |
| -1. Installing [C# Dev Kit][csdevkitextension] will automatically install this extension as a required dependency |
| 7 | +1. Installing [C# Dev Kit][csdevkitextension] will automatically install this extension as a required dependency. |
10 | 8 | 2. Open a folder/workspace that contains a C# project (.csproj) and a C# solution (.sln) and the extension will activate.
|
11 | 9 | 3. Whether you install C# Dev Kit or just the C# extension, the [.NET Runtime Installer Tool extension](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.vscode-dotnet-runtime) will be installed as a dependency.
|
12 | 10 |
|
13 |
| -Note: If working on a solution that requires versions prior to .NET 6, install a Full Framework runtime and MSBuild tooling. |
14 |
| - * Set omnisharp.useModernNet to false and if you are on the pre-release verion, set dotnet.server.useOmnisharp to true |
15 |
| - * Windows: .NET Framework along with MSBuild Tools |
16 |
| - * MacOS/Linux: Mono with MSBuild |
| 11 | +Note: If working on a solution that requires versions prior to .NET 6 or if you have a Unity project, install a Full Framework runtime and [MSBuild tooling](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022). |
| 12 | + * Set omnisharp.useModernNet to false and set dotnet.server.useOmnisharp to true |
| 13 | + * Uninstall or disable C# Dev Kit |
| 14 | + * Windows: .NET Framework along with [MSBuild Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) |
| 15 | + * MacOS/Linux: [Mono with MSBuild](https://www.mono-project.com/download/preview/) |
17 | 16 |
|
18 | 17 | ## Features
|
19 |
| - * Refactoring |
20 |
| - * Code Navigation (GTD, FAR) |
21 |
| - * Code Completions |
22 |
| - * Roslyn powered semantic awareness |
| 18 | +Learn more about the rich features of the C# extension: |
| 19 | + * [Refactoring](https://code.visualstudio.com/docs/csharp/refactoring): Edit your code with code fixes and refactorings |
| 20 | + * [Navigation](https://code.visualstudio.com/docs/csharp/navigate-edit): Explore and navigate your code with features like Go To Definition and Find All References |
| 21 | + * [IntelliSense](https://code.visualstudio.com/docs/csharp/navigate-edit): Write code with auto-completion |
| 22 | + * [Formatting and Linting](https://code.visualstudio.com/docs/csharp/formatting-linting): Format and lint your code |
| 23 | + |
| 24 | +For more information you can: |
| 25 | + |
| 26 | +- [Follow our C# tutorial](https://code.visualstudio.com/docs/csharp/get-started) with step-by-step instructions for building a simple app. |
| 27 | +- Check out the [C# documentation](https://code.visualstudio.com/docs/languages/csharp) on the VS Code site for general information about using the extension. |
23 | 28 |
|
24 | 29 | ## How to use OmniSharp?
|
25 |
| -If you don’t want to take advantage of the great Language Server features, you can revert back to using OmniSharp in the pre-release extension by going to the Extension settings and setting `dotnet.server.useOmnisharp` to true. This will require that you restart VS Code to take effect. You can also switch back to the Switch to Release Version to revert back to the C# extension powered by OmniSharp. |
| 30 | +If you don’t want to take advantage of the great Language Server features, you can revert back to using OmniSharp by going to the Extension settings and setting `dotnet.server.useOmnisharp` to true. Next, uninstall or disable C# Dev Kit. Finally, restart VS Code for this to take effect. |
26 | 31 |
|
27 | 32 |
|
28 | 33 | ## Found a Bug?
|
|
0 commit comments