- For Mono-based development (e.g. Unity) that requires full .NET framework, you need to set
"omnisharp.useGlobalMono": "always"
. The current value of "auto" will remain "never" until Mono upgrades their bundled MSBuild version. - After selecting a solution filter (*.slnf) from the project selector, the solution's name will be displayed in the status bar instead of the filter's.
- Known limitations with the preview Razor (cshtml) language service to be addressed in a future release:
- Only ASP.NET Core projects are supported (no support for ASP.NET projects)
- Error squiggles misaligned for expressions near the start of a new line
- Emmet based abbreviation expansion is not yet supported (See note in readme for how to enable through your settings.json)
- There currently is no completion support for package references in csproj files. (#1156)
- As an alternative, consider installing the MSBuild Project Tools extension by @tintoy.
- Renaming symbol fails within a file that had recently been renamed without saving changes.
- As a workaround, make an edit within the file before using Rename Symbol.
- Debugger changes:
- Added support for osx-arm64 debugging (#4390)
- Added support for exception conditions. See documentation for more information (#4356).
- Fixed an issue with character encoding for multi-byte characters written to the debug console (#4398)
- Support solution filters (*.slnf) (PR: #4481)
- Prompt user to install Blazor WASM companion extension if needed (PR: #4392)
- Add path to dotnet so child processes can use the CLI (PR: #4459)
- Give more information when Mono is missing or invalid. (#4428, PR: #4431)
- Revert incremental change forwarding (PR: #4477)
- Fixes to asset generation (PR: #4402)
- Add properties to blazorwasm debug configuration. (dotnet/aspnetcore#30977, PR: #4445)
- Avoid white status bar items to ensure contrast (#4384, PR: #4385)
- Update OmniSharp to 1.37.8
- Update Roslyn version to
3.10.0-1.21125.6
(PR: omnisharp-roslyn#2105) - Update included build tools to closely match NET 6 Preview 1 SDK (PR: omnisharp-roslyn#2103)
- Improve custom error messages for MSB3644 (PR: omnisharp-roslyn#2097)
- Do not call FindReferencesAsync for null symbol (omnisharp-roslyn#2054, PR: omnisharp-roslyn#2089)
- use an OmniSharp specific message for MSB3644 (omnisharp-roslyn#2029, PR: omnisharp-roslyn#2069)
- changed the default RunFixAllRequest timeout to 10 seconds (PR: omnisharp-roslyn#2066)
- Support Solution filter (.slnf) (PR: omnisharp-roslyn#2121)
- updated to IL Spy 7.0.0.6372 (PR: omnisharp-roslyn#2113)
- Add sentinel file to MSBuild to enable workload resolver (#4417, PR: omnisharp-roslyn#2111)
- fixed CS8605 "Unboxing possibly null value" (PR: omnisharp-roslyn#2108)
- Update Roslyn version to
- Updated Razor support (PR: #4470)
- Bug fixes
- Add option to organize imports during document formatting. (PR: #4302)
- Update to use zero based indexes (PR: #4300)
- Improve request queues to improve code completion performance (PR: #4310)
- Add setting to control whether to show the OmniSharp log on error (#4102, #4330, PR: #4333)
- Support building launch assets for NET6-NET9 projects (#4346, PR: #4349)
- Add debugger support for Concord extensions. See the ConcordExtensibilitySamples wiki for more information.
- Update OmniSharp version to 1.37.6
- Handle records in syntax highlighting (omnisharp-roslyn#2048, PR: omnisharp-roslyn#2049)
- Remove formatting on new line (PR: omnisharp-roslyn#2053)
- Validate highlighting ranges in semantic highlighting requests (PR: omnisharp-roslyn#2055)
- Delay project system init to avoid solution update race (PR: omnisharp-roslyn#2057)
- Use "variable" kind for parameter completion (omnisharp-roslyn#2060, PR: omnisharp-roslyn#2061)
- Log request when response fails (omnisharp-roslyn#2064)
- Updated Debugger support (PR: #4281)
- Updated the version of .NET that the debugger uses for running its own C# code to .NET 5
- Updated .NET debugging services loader to address problem with debugging after installing XCode12 (dotnet/runtime/#42311)
- Fixed integrated terminal on non-Windows (#4203)
- Updated Razor support (PR: #4278)
- Bug fixes
- Update OmniSharp version to 1.37.5 (PR: #4299)
- Update Roslyn version to 3.9.0-2.20570.24 (PR: omnisharp-roslyn#2022)
- Editorconfig improvements - do not lose state, trigger re-analysis on change (omnisharp-roslyn#1955, #4165, #4184, PR: omnisharp-roslyn#2028)
- Add documentation comment creation to the FormatAfterKeystrokeService (PR: omnisharp-roslyn#2023)
- Raise default GotoDefinitionRequest timeout from 2s to 10s (#4260, PR: omnisharp-roslyn#2032)
- Workspace create file workaround (PR: omnisharp-roslyn#2019)
- Added
msbuild:UseBundledOnly
option to force the usage of bundled MSBuild (PR: omnisharp-roslyn#2038)
- Support auto doc comment generation (#8, PR: #4261)
- Add schema support for appsettings.json (#4279, PR: #4280)
- Add schema support for global.json (PR: #4290)
- Update remoteProcessPickerScript windows ssh exit (#3482, PR: #4225)
- Do not start OmniSharp server in Live Share scenarios (#3910, PR: #4038)
- Suppress codelens for IEnumerable.GetEnumerator (#4245, PR: #4246)
- Allow arm64 MacOS to debug dotnet projects (#4277, PR: #4288)
- Update OmniSharp version to 1.37.4 (PR: #4224)
- Fixed global Mono MSBuild version reporting (PR: omnisharp-roslyn#1988)
- Fixed incremental changes and completion in Cake (PR: omnisharp-roslyn#1997)
- Omnisharp now uses libPaths and sourcePaths defined in custom .rsp file for scripting (PR: omnisharp-roslyn#2000)
- C# scripting should use language version "latest" by default (PR: omnisharp-roslyn#2001)
- Improve handling with Cake Script Service (PR: omnisharp-vscode#2013)
- Updated to latest Dotnet.Script scripting packages for .NET 5.0 (omnisharp-vscode#2020, PR: omnisharp-vscode#2012)
- Updated Roslyn to
3.8.0
, MSBuild to16.8.0
, DotNetHostResolver to5.0.0
, Nuget packages to5.8.0-rc.6930
and MSBuildSDKResolver to5.0.101-servicing.20564.2
to match .NET 5.0.100 SDK (PR: omnisharp-vscode#2015, omnisharp-vscode#2016) - Workspace create file workaround for VS Code (to avoid race condtion on newly created files) (omnisharp-vscode#4181, PR: omnisharp-vscode#2019)
- Response file can now used enviroment variables in the path + more error handling (PR: omnisharp-vscode#2008)
- Do not start OmniSharp server in Live Share scenarios (#3910, PR: #4038)
- Update remoteProcessPickerScript windows ssh exit (PR: #4225)
- Only suppress file changed notifications for C# files (#4178, PR: #4230)
- Suppress codelens for IEnumerable.GetEnumerator (#4245, PR: #4246)
- Do not call updateBuffer if there are no changes. (PR: #4170)
- Only skip file changed events when document is open. (PR: #4178)
- Set meaning of UseGlobalMono "auto" to "never" since Mono 6.12.0 still ships with MSBuild 16.7 (PR: #4130)
- Ensure that the rename identifier and run code action providers do not apply changes twice (PR: #4133)
- Do not send file changed events for .cs files (PR: #4141, #4143)
- Update Razor to 6.0.0-alpha.1.20529.17:
- Improvements to HTML colorization for non-C# portions of the document.
- Bug fix - the
razor.format.enable
option is honored again
- Use incremental changes to update language server (PR: #4088)
- Set meaning of UseGlobalMono "auto" to "always" now that Mono 6.12.0 ships with MSBuild 16.8 (PR: #4115)
- Updated OmniSharp to 1.37.3
- Fixed a bug when the server wouldn't start on MacOS/Linux when a username contained a space (PR: omnisharp-roslyn/#1979)
- Update to Mono 6.12.0 (PR: omnisharp-roslyn/#1981)
- Fix responsiveness regression with targeted DiagnosticWorker revert (omnisharp-roslyn/#1982, omnisharp-roslyn/#1983, PR: omnisharp-roslyn/#1984)
- Fix ps call for Alpine images (#4023, PR: #4097)
- Support TextEdit in completion responses (PR: @4073)
- Updated Razor support
- Updated OmniSharp version (should improve stability) dotnet/aspnetcore-tooling#20320
- Corrected positioning for
@using
for components added by light bulb. dotnet/aspnetcore-tooling#25019 - Mixed HTML & C# Razor formatting support (dotnet/aspnetcore-tooling#25470) / (dotnet/aspnetcore-tooling#14271)
- Add using for C# Type light bulb (dotnet/aspnetcore-tooling#18173)
- Fully qualify C# Type light bulb (dotnet/aspnetcore-tooling#24778)
- Added support for engine logging on .NET process for Blazor WASM apps (OmniSharp/omnisharp-vscode#4070)
- Fixed bug in clean-up of Blazor WASM debugging session (OmniSharp/omnisharp-vscode#4056)
- Debugger Features:
- Add support for Function Breakpoints (#295)
- Debugger Fixes:
- Update OmniSharp to 1.37.2 (PR: #4107)
- Updated MSBuild, MSBuild resolvers and Roslyn to match .NET Core 5.0 RC2 and VS 16.8 Preview 4. (PR: omnisharp-roslyn/#1971, PR: omnisharp-roslyn/#1974)
- Decouple FixAll from the workspace (omnisharp-roslyn/#1960, PR: omnisharp-roslyn/#1962)
- Added binding redirects for Microsoft.CodeAnalysis.Features and Microsoft.CodeAnalysis.CSharp.Features (PR: omnisharp-roslyn/#1964)
- Always log error responses with error level (PR: omnisharp-roslyn/#1963)
- Added support for override property completion. Warning: contains breaking change, as
InsertText
was removed from the response, please useTextEdit
instead (PR: omnisharp-roslyn/#1957) - Correctly handle that don't produce references (PR: omnisharp-roslyn/#1956)
- Marked
/autocomplete
endpoint as obsolete - the clients should be switching to/completion
and/completion/resolve
(PR: omnisharp-roslyn/#1951) - Fixed escapes in regex completions (omnisharp-roslyn/#1949, PR: omnisharp-roslyn/#1950)
- Fixed completion on part of existing string (omnisharp-vscode#4063, PR: omnisharp-roslyn/#1941)
- Fixed LSP completion item kinds (PR: omnisharp-roslyn/#1940)
- Added support for textDocument/implementation in LSP mode (PR: omnisharp-roslyn/#1970)
- Fixed namespace icon in completion response (omnisharp-vscode#4051, PR: omnisharp-roslyn/#1936)
- Improved performance of find implementations (PR: omnisharp-roslyn/#1935)
- Add support for new quick info endpoint when working with Cake (PR: omnisharp-roslyn/#1945)
- Add support for new completion endpoints when working with Cake (omnisharp-roslyn/#1939, PR: omnisharp-roslyn/#1944)
- When an analyzer fails to load, log an error (PR: omnisharp-roslyn/#1972)
- Added support for 'extract base class' (PR: omnisharp-roslyn/#1969)
- OmniSharp.Path can only be set in user settings (PR: omnisharp-roslyn/#1946)
- Add support for code actions besides ApplyChangesOperation's (PR: omnisharp-roslyn/#1724)
- Ensure that all quickinfo sections have linebreaks between them, and don't add unecessary duplicate linebreaks (PR: omnisharp-roslyn#1900)
- Support completion of unimported types (PR: omnisharp-roslyn#1896)
- Exclude Misc project from InternalsVisibleTo completion (PR: omnisharp-roslyn#1902)
- Ensure unimported things are sorted after imported things (PR: omnisharp-roslyn#1903)
- Correctly handle multiple reference aliases (PR: omnisharp-roslyn#1905)
- Better handle completion when the display text is not in the final result (PR: omnisharp-roslyn#1908)
- Correctly mark hover markup content as markdown (omnisharp-roslyn#1906, PR: omnisharp-roslyn#1909)
- Upgrade lsp (omnisharp-roslyn#1898, PR: omnisharp-roslyn#1911)
- Updated to ILSpy 6.1.0.5902 (PR: omnisharp-roslyn#1913)
- Updated to NET 5.0 preview8 (PR: omnisharp-roslyn#1916)
- Add HTTP Driver back to build.json (PR: omnisharp-roslyn#1918)
- Updated the docs to mention .NET 4.7.2 targeting pack (PR: omnisharp-roslyn#1922)
- Support for configurations remapping in solution files (omnisharp-roslyn#1828, PR: omnisharp-roslyn#1835)
- Only run dotnet --info once for the working directory (PR: omnisharp-roslyn#1925)
- Update build tool versions for NET 5 RC1 (PR: omnisharp-roslyn#1926)
- Update Roslyn to 3.8.0-3.20451.2 (PR: omnisharp-roslyn#1927)
- Clean up Blazor WebAssembly notifications (PR: #4018)
- Remove proposed api attribute (PR: #4029)
- New completion service including override and unimported type completion (
omnisharp.enableImportCompletion
) (PR: #3986)
- Register FixAll commands for disposal (#3984, PR: #3985)
- Include version matched target files with minimal MSBuild (PR: omnisharp-roslyn#1895)
- Fix lack of trailing italics in quickinfo (PR: omnisharp-roslyn#1894)
- Set meaning of UseGlobalMono "auto" to "never" until Mono updates their MSBuild (PR: #3998)
- Updated Razor support
- Fully qualify component light bulb (dotnet/aspnetcore-tooling#22309)
- Add using for component light bulb (dotnet/aspnetcore-tooling#22308)
- Create component from tag light bulb (dotnet/aspnetcore-tooling#22307)
- Go to definition on Blazor components (dotnet/aspnetcore-tooling#17044)
- Rename Blazor components (dotnet/aspnetcore-tooling#22312)
- Prepare Blazor debugging to have better support for "Start without debugging" scenarios (dotnet/aspnetcore-tooling#24623)
- Fix typo in supressBuildAssetsNotification setting name (#3941, PR: #3942)
- Introduced a new
/quickinfo
endpoint to provide a richer set of information compared to/typeinfo
. Consumers are encouraged to use it as their hover provider (omnisharp-roslyn#1808, PR: omnisharp-roslyn#1860 - Added support for Roslyn
EmbeddedLanguageCompletionProvider
which enables completions for string literals forDateTime
andRegex
(omnisharp-roslyn#1871) - Improve performance of the
textDocument/codeAction
request. (PR: omnisharp-roslyn#1814) - Provide a warning when the discovered MSBuild version is lower than the minimumMSBuildVersion supported by the configured SDK (PR: omnisharp-roslyn#1875)
- Use the real MSBuild product version during discovery (PR: omnisharp-roslyn#1876)
- Fixed debugging in .NET 5 preview SDKs (#3459, PR: omnisharp-roslyn#1862)
- Move omnisharp vscode to the new hover implementation (#3928)
- Ignore screen size is bogus errors with ps (#3580, PR: #3961)
- Fix all providers support (PR: #3440, PR: omnisharp-roslyn#1581)
- Fix MSBuild version mismatch with new SDKs (omnisharp-vscode#3951, PR: #1883)
- Updated Razor support
- Improved Semantic Highlighting support by fixing some scenarios which might lead to thrown exceptions and incorrect results. dotnet/aspnetcore-tooling#2126
- Fixed support in the case of projects with spaces in path. dotnet/aspnetcore#23336
- Various performance improvements.
@inject
completion dotnet/aspnetcore#22886- Improved behavior in cases where directory is not available. dotnet/aspnetcore-tooling#2008
- Added the
Extract to CodeBehind
light bulb code action. dotnet/aspnetcore-tooling#2039
- Use global MSBuild property when resetting target framework (omnisharp-roslyn#1738, PR: omnisharp-roslyn#1846)
- Do not use Visual Studio MSBuild if it doesn't have .NET SDK resolver (omnisharp-roslyn#1842, omnisharp-roslyn#1730, PR: omnisharp-roslyn#1845)
- Only request dotnet info once for the solution or directory (omnisharp-roslyn#1844, PR: omnisharp-roslyn#1857)
- Allow client to specify symbol filter for FindSymbols Endpoint. (PR: omnisharp-roslyn#1823)
- Upgraded to Mono 6.10.0.105, msbuild 16.6 and added missing targets (PR: omnisharp-roslyn#1854)
- Make "Run/debug tests in context" position a link (#3915)
- Update browser launch regex to support non-default logging frameworks (#3842)
- Added LSP handler for
textDocument/codeAction
request. (PR: omnisharp-roslyn#1795) - Expose a custom LSP
omnisharp/client/findReferences
command via code lens (meant to be handled by LSP client). (PR: #omnisharp-roslyn/1807) - Added
DirectoryDelete
option toFileChangeType
allowing clients to report deleted directories that need to be removed (along all the files) from the workspace (PR: #3829, PR: omnisharp-roslyn#1821) - Do not crash when plugin assembly cannot be loaded (omnisharp-roslyn#1307, PR: omnisharp-roslyn#1827)
- Update browser launch regex to support non-default logging frameworks (#3842)
- Improved support for Codespaces
- Add setting for enabling go to decompilation (PR: #3774)
- Add experimental Semantic Highlighter
csharp.semanticHighlighting.enabled
(#3565, PR: #3667 - Add commands for Run and Debug Tests in Context (PR: #3772, PR: omnisharp-roslyn#1782)
- Do not add references CodeLens to Dispose methods (#3243, PR: #3780)
- Add Visual Studio 2019 themes with semantic colors (PR: #3790)
- Added support for
WarningsAsErrors
in csproj files (PR: omnisharp-roslyn#1779) - Added support for
WarningsNotAsErrors
in csproj files (omnisharp-roslyn#1681, PR: #1784) - Improved MSBuild scoring system (omnisharp-roslyn#1783, PR: omnisharp-roslyn#1797)
- Updated OmniSharp.Extensions.LanguageServer to
0.14.2
to fix synchronisation (PR: omnisharp-roslyn#1791) - Add test discovery and NoBuild option to test requests (PR: omnisharp-roslyn#1719)
- Updated Razor support
- Enable Semantic Highlighting for Razor TagHelpers and Blazor components (dotnet/aspnetcore#21713)
- Directive and TagHelper Attribute Completions are now committed contextually with
=
,:
and - Removed TagHelper attribute completion snippet support as we felt the typing experience was superior without it.
- Add support for Blazor WebAssembly-specific debug adapter (dotnet/aspnetcore-tooling#1885)
- Fadeout unused variable names (#1324, PR: #3733)
- Updated debugger (PR: #3729)
- Fixed not supported exception when trying to decompile a BCL assembly on Mono. For now we do not try to resolve implementation assembly from a ref assembly (PR: omnisharp-roslyn#1767)
- Added support for generic classes in test runner (#3722, PR: omnisharp-roslyn#1768)
- Improved autocompletion performance (PR: omnisharp-roslyn#1761)
- Move to Roslyn's .editorconfig support (omnisharp-roslyn#1657, PR: omnisharp-roslyn#1771)
- Fully update CompilationOptions when project files change (PR: omnisharp-roslyn#1774)
- Updated Razor support (PR:#3696)
- Razor support for
<text>
tag completions. - Ability to restart the Razor Language Server to activate changes to the
razor.trace
level. - Bug fixes and performance improvements.
- Razor support for
- Support for
<RunAnalyzers />
and<RunAnalyzersDuringLiveAnalysis />
(PR: omnisharp-roslyn#1739) - Add
typeparam
documentation comments to text description (#3516, PR: omnisharp-roslyn#1749) - Tag
#region
blocks appropriately in the block structure service (#2621, PR: omnisharp-roslyn#1748)
- Support for .NET Core 3.1 in csx files (PR: #1731)
- Update the minimal MSBuild to better support .NET 5 Previews (omnisharp-vscode#3653, PR: #1746)
- Fixed freezing and unresponsiveness when opening folder with many nested sub-folders (PR: #3681)
- Fixed handling of dismiss response to assets prompt (PR: 3678)
- Fixed an issue where Razor formatting fails in the presence of @using directives
- Added support for
annotations
value ofNullable
csproj property (omnisharp-roslyn#1721, PR: omnisharp-roslyn#1722) - Added ability to specify custom RunSettings for tests (PR: #3573, PR: omnisharp-roslyn#1710)
- Change Marketplace publisher for the C# extension from ms-vscode to ms-dotnettools
- Ignore diagnostics from virtual files (dotnet/aspnetcore#18927, PR: #3592)
- Detect and create Blazor WASM launch and debug settings (dotnet/aspnetcore#17549, PR: #3593)
- Updated Razor support (PR:3594)
- Support for @code/@functions block formatting
- Updated Razor's TextMate grammar to include full syntactic colorization
- Several bug fixes
- Fixed out of bounds exception in line mapping (#3485, PR: omnisharp-roslyn#1707)
- Added support for aliases in project references (omnisharp-roslyn#1685, PR: omnisharp-roslyn#1701)
- Raised the lowest discovered VS2019 version to 16.3 (omnisharp-roslyn#1700, PR: (#1713)(OmniSharp/omnisharp-roslyn#1713))
- Fixed a bug where organizing usings clashed with other formatting settings (PR: omnisharp-roslyn#1715)
- Updated the bundled to Mono 6.8.0 and MSBuild to be copied from Mono 6.8.0 (omnisharp-roslyn#1693, PR: omnisharp-roslyn#1697)
- Included NugetSDKResolver in the minimal MSBuild, which introduces support for Nuget based project SDKs like Arcade (omnisharp-roslyn#1678, PR: omnisharp-roslyn#1696)
- Added option (
csharp.supressBuildAssetsNotification
) to surpress missing build asset notifications (PR:#3538) - The minimum Mono version required to run OmniSharp on has been increased to 6.4.0
- Updated Razor support (PR:#3524)
- Added quick info (hover) support for TagHelper and Blazor components. You can now hover over TagHelpers, Components and their attributes to understand what associated C# type you're hovering over in addition to an attributes expected value type.
- Migrated Razor's project understanding from the VSCode extension into the Language Server. This enables the language server to reboot without extra assistance (reliability) from an LSP client and also enables future Razor LSP clients to have richer functionality with less "work".
- Added C# light bulbs to enable users to "Fully Qualify" members that are causing errors.
- Expanded Razor's TextMate grammar colorization support to understand email addresses and
await foreach
. - Several bug fixes
- Updated Debugger support (PR:#3515)
- Added option to search the NuGet.org Symbol Server
- Added options to control logging Process and Thread exits while debugging
- Fixed a bug where completion items didn't decode symbols corectly (impacted, for example, object initializer completion quality) (#3465, PR:omnisharp-roslyn#1670)
- Updated to MsBuild 16.4.0 on Linux/MacOS (PR:omnisharp-roslyn#1669)
- Added support for implement type options - it is now possible to define whether code-fix/refactoring generated properties should be auto- or throwing-properties and at which place in the class should newly generated members be inserted. They can be set via OmniSharp configuration, such as
omnisharp.json
file. (PR: omnisharp-roslyn#1672) - Added support for organizing usings on format. This can be set via OmniSharp configuration, such as
omnisharp.json
file. (PR:omnisharp-roslyn#1686) - Improved support for .NET Core 3.1
- Use the base filename instead of 'ClassName' in ctor snippet (PR:#3385)
- Added command to re-run code analysis on single project or all projects (PR:#3089)
- Updated Razor support (PR:#3445)
- Rename support
- Go to definition support
- Go to implementation support
- Find all references support
- CodeLens support
- Several mainline bug fixes
- Updated Razor grammar for better colorization (PR:#3448)
- Updated to MsBuild 16.4.0 (PR:omnisharp-roslyn#1662)
- Line pragma is now respected in find references (omnisharp-roslyn#1649, PR:omnisharp-roslyn#1660)
- Do not set mono paths when running in standalone mode (omnisharp-vscode#3410, omnisharp-vscode#3340, omnisharp-roslyn#1650, PR:omnisharp-roslyn#1656)
- Fixed a bug where OmniSharp would crash on startup if the path contained
=
sign (omnisharp-vscode#3436, PR:omnisharp-roslyn#1661) - Improved support for .NET Core 3.1
- Update Razor to work for 3.1 SDKs (PR:#3406)
- Support plugins configuration in omnisharp.json (PR:omnisharp-roslyn#1615)
- Improved support for .NET Core 3.1
- Updated the embedded Mono to 6.4.0 (PR:omnisharp-roslyn#1640)
- Improved support for .NET Core 3
- Fixed a bug that caused CS0019 diagnostic to be erroneously reported when comparing to
default
(omnisharp-roslyn#1619, PR:omnisharp-roslyn#1634) - Fixed a concurrency bug in scripting/Cake support (omnisharp-roslyn#1627)
- Correctly respect request cancellation token in metadata service (omnisharp-roslyn#1631)
- Improved support for .NET Core 3
- Fixed regression that caused "go to metadata" to not work (omnisharp-roslyn#1624, PR: omnisharp-roslyn#1625)
- Improved support for .NET Core 3
- Added support for
CheckForOverflowUnderflow
in csproj files - Improved support for .NET Core 3
- Improved support for .NET Core 3
- Fixed a regression which caused AllowUnsafeCode in csproj to also enable TreatWarningsAsErrors behavior.(omnisharp-roslyn#1565, PR: omnisharp-roslyn#1567)
- Added a
omnisharp.enableEditorConfigSupport
setting to enable support for .editorconfig #3136 (Contributed by @hoffs)(PR: omnisharp-roslyn#1526 (Contributed by @filipw)) - Modified the auto generated tasks in tasks.json to generate full paths and disable summary to fix the problem of no source links in the problems panel. (PR:#3145)
- Added support for Roslyn code actions that normally need UI - they used to be explicitly sipped by OmniSharp, now it surfaces them with predefined defaults instead. (omnisharp-roslyn#1220, PR: #1406) These are:
- extract interface
- generate constructor
- generate overrides
- generate Equals and GetHashCode
- Improved analyzers performance by introducing background analysis support (omnisharp-roslyn#1507)
- According to official Microsoft .NET Core support policy, .NET Core 1.0 and 1.1 (
project.json
-based .NET Core flavors) have reached end of life and went out of support on 27 June 2019. OmniSharp features to support that, which have been obsolete and disabled by default since version 1.32.2 (2018-08-07), are now completely removed. - Fixed a bug where some internal services didn't respect the disabling of a project system (omnisharp-roslyn#1543)
- Improved the MSBuild selection logic. The standalone instance inside OmniSharp is now preferred over VS2017, with VS2019 given the highest priority. This ensures that .NET Core 3.0 works correctly. It is also possible manually provide an MSBuild path using OmniSharp configuration, which is then always selected. (omnisharp-roslyn#1541, PR: omnisharp-roslyn#1545)
{ "MSBuild": { "MSBuildOverride": { "MSBuildPath": "C:\\Program Files (x86)\\Microsoft Visual Studio\\2017\\Enterprise\\MSBuild\\15.0\\Bin", "Name": "vs2017 msbuild" } } }
- Added support for AdditionalFiles in csproj files (omnisharp-roslyn#1510, PR: omnisharp-roslyn#1547)
- Fixed a bug in .editorconfig where formatting settings were not correctly passed into external code fixes (omnisharp-roslyn#1558, PR: omnisharp-roslyn#1559)
- Updated the auto-generated launch.json to use new mechanism for starting web browser. For more information: https://aka.ms/VSCode-CS-LaunchJson-WebBrowser
- Improved support for .NET Core 3
- Updates to Razor support
- Made QuickInfo display more consistent with Visual Studio. (#2610) (Contributed by @paladique)(PR: #3090)
- Added support for fading unnecessary code and using statements #2873
- Updated debugger to work correctly on Linux distributions with openssl 1.1 such as Ubuntu 19.04 (#3010)
- Fixed OmniSharp hanging on wildcard Nuget package references.(PR: omnisharp-roslyn#1473)
- OmniSharp now uses correct 4.7.2 framework sku to prompt for installation of .NET 4.7.2 if missing.(PR: omnisharp-roslyn#1469).
- Improved support for .NET Core 3
- Added support for roslyn analyzers, code fixes and rulesets which can be enabled via
omnisharp.enableRoslynAnalyzers
setting. - Improved Razor diagnostics
- Razor tooling support for tag helpers
- Added a
csharp.maxProjectFileCountForDiagnosticAnalysis
setting to configure the file limit when the extension stops reporting errors for whole workspace. When this threshold is reached, the diagnostics are reported for currently opened files only. This mechanism was available in previous versions, but now can be configured. The default is 1000. (PR: #1877) - Added a
omnisharp.enableMsBuildLoadProjectsOnDemand
setting to load project for files that were opened in the editor. This setting is useful for big C# codebases and allows for faster initialization of code navigation features only for projects that are relevant to code that is being edited._(Contributed by @dmgonch)(PR: #2750) - Added initial support for C# 8. (PR: omnisharp-roslyn#1365)
- Fixed finding references to operator overloads (Contributed by @SirIntruder) (PR: omnisharp-roslyn#1371)
- Improved handling of files moving on disk (PR: omnisharp-roslyn#1368)
- Improved detection of MSBuild when multiple instances are available (Contributed by @johnnyasantoss ) (PR: omnisharp-roslyn#1349)
- Fixed a bug where the "OmniSharp" and "C# log" would steal the editor focus and hinder the user's development flow.(PR: #2828)
- Improvement in code load times for the extension by using webpack (PR: #2835)
- Added tasks for "dotnet publish" and "dotnet watch" in the initial asset generation (Contributed by @timheuer ) (PR: #2903)
- Added support for set next statement. Set next statement is a feature that has been available for a long time in full Visual Studio, and this brings the feature to Visual Studio Code. This feature allows developers to change what code is executed next in the target program. For example, you can move the instruction pointer back to re-execute a function that you just ran so you can debug into it, or you can skip over some code that you don't want to execute. To use this feature, move your cursor to the statement you would like to execute next, and either open the editor context menu and invoke 'Set Next Statement (.NET)', or use the keyboard shortcut of Ctrl+Shift+F10 (#1753)
- Improved responsiveness by making the debugger backend asynchronous and cancelable so that operations (ex: evaluate expression 'xyz') can be aborted on step/go/disconnect (#1215).
- Added support for pagination of evaluation result children. Before, if an element in the watch/variables/data tip had a large number of child elements, then the first 1,000 children would be calculated up front and no others would be shown. This could be very slow. Now only the first 25 elements are calculated and there is a '[More]' node to obtain additional values. Note that if you are trying to find a particular element in a large collection it is still best to use Linq (example:
myCollection.Where(x => x > 12).ToList()
). - Added support for showing return values in the variables window (#859).
- Fixed evaluating string functions with interpretation in .NET Core 2.1+. Evaluation uses interpretation for conditional breakpoints, evaluating methods that take a lambda, etc (#2683).
- Many small improvements to launch.json/tasks.json generation. Highlights include a selection dialog if the workspace contains multiple launchable projects, a few simplifications to reduce the number of fields in the default launch.json, and switching the 'problem matcher' for build tasks. (PR: #2780)
- Updated the default symbol cache directory to match other .NET Tools (#2797).
- Updated Razor language service to fix various Razor editing reliability issues. For details see https://github.com/aspnet/Razor.VSCode/releases/tag/1.0.0-alpha2.
- Added preview Razor (cshtml) language service with support for C# completions and diagnostics in ASP.NET Core projects. Please report issues with the preview Razor tooling on the aspnet/Razor.VSCode repo. To disable the preview Razor tooling set the "razor.disabled" setting to
true
. (PR: 2554) - Added omnisharp.minFindSymbolsFilterLength setting to configure the number of characters a user must type in for "Go to Symbol in Workspace" command to return any results (default is 0 to preserve existing behavior). Additionally added omnisharp.maxFindSymbolsItems for configuring maximum number of items returned by "Go to Symbol in Workspace" command. The default is 1000. (PR: #2487)
- Added a command - "CSharp: Start authoring a new issue on GitHub" to enable the users to file issues on github from within the extension with helpful config information from their system.(PR: #2503)
- Fixed crash at the end of debug sessions on Linux (#2439)
- Fixed searching for PDBs in original built location (#2483)
- Fixed launching the web browser against an ASP.NET project that uses wildcard ('*') bindings (#2528)
- Update extension to handle upcoming breaking change to launch.json configurations in VS Code 1.28. (PR: #2558)
- Fixed a bug where OmniSharp flame was red in spite of OmniSharp loading the projects without any errors. (PR: #2450)
- Fixed launch.json
envFile
option on Windows. (PR: #2560) - Fixed a problem with tracking virtual documents from other providers. (PR: #2562)
-
Separated the existing "Restore Packages" option in the Command Palette into two distinct functions:
- "Restore Project" - Displays a drop-down that shows all the available projects in the solution or in the workspace. Selecting one of them would trigger a dotnet restore for the particular project.
- "Restore All Projects" - Triggers a dotnet restore for all projects in the current solution or workspace.
-
Modified the "Unresolved dependencies" prompt to restore the all the projects in the currently selected solution or workspace. (PR: #2323)
-
Added support to configure the default *.sln file loaded when opening a project with multiple *.sln files in the root. (Contributed by @janaka) (PR: #2053)
-
Added support for tracking opening, closing and changing of virtual documents that don't exist on disk. (PR: #2436) (Contributed by @NTaylorMullen)
-
Enabled IDE features for .cs files that are not part of a project. (PR: #2471, omnisharp-roslyn#1252)
- Added a prompt to "Restart OmniSharp" when there is a change in omnisharp "path", "useGlobalMono" or "waitForDebugger" settings.(PR: #2316)
-
Improved diagnostics by refreshing them when the active editor changes or the current window is focused. (PR: #2317) (Contributed by @SirIntruder)
-
Improved completions by adding the preselect property so the best match is preselected. (PR: #2388)
- Added test execution output to the output of the Run/Debug Test CodeLens. (PR: #2337, #2343, omnisharp-roslyn#1203)
- Fixed a bug where a debug session could not be started and duplicate logs were displayed after a previous one failed due to build failure. (PR: #2405, omnisharp-roslyn#1239)
- Added
monoPath
option to use the mono installation at the specified path when theuseGlobalMono
is set to "always" or "auto". (PR: #2425) (Contributed by @shana)
- Added support for launching with environment variables stored in a seperate file from launch.json via a new
envFile
option. (PR: #2462, #1944) (Contributed by @SebastianPfliegel) - Fixed editting breakpoint conditions while debugging with recent versions of VS Code. (#2428)
- Added support for hit count breakpoint conditions. (#895)
- Support the
applicationUrl
property in launchSettings.json. (#2296) - Improve the error message when attaching to privileged processes on Linux and macOS. (#477)
- Fixed a 1.30.0 regression that prevented the script project system from working on Unix-based systems (omnisharp-roslyn#1184, PR: omnisharp-roslyn#1185) (Contributed by @filipw)
- Fixed a regression that could cause the debugger to crash on Windows (#2297).
- The minimum Mono version required to run OmniSharp on has been increased to 5.8.1.
-
New features:
- Adds support for Source Link, Symbol Servers and other more advanced symbol options (#373)
- Adds launch.json option to suppress Just-In-Time compiler optimizations.
- Due to the previous two items and work from the .NET Team, it is now possible to easily debug into ASP.NET itself in projects running against .NET Core 2.1. Instructions are in the wiki.
- Adds support for pulling in environment variables from
${cwd}/Properties/launchSettings.json
. This means that if you add environment variable configuration to your launchSettings.json file, they will now be used when you start your app from Visual Studio Code like they previously would be used from the command line (dotnet run
), and from Visual Studio. (#2017)
-
Bug fixes:
- On Linux, this reduces the native dependencies of the debugger to match the .NET Core 2.1 runtime. The Linux .NET Core 2.1 runtime reduced its native dependencies over all the previous versions, but the debugger still had the same dependencies as .NET Core 2.0. With this fix, the debugger will now continue to work on Linux after installing the .NET Core runtime and nothing else. (#2199)
- Fixes async call stacks with the .NET Core 2.1 runtime. (#1892)
- Fixes the debugger's browser launch code when launching projects configured to use Application Insights. (2177)
- Fixed regression where the "Generate Type in New File" code action would create an empty file. (#2112, PR: omnisharp-roslyn#1143)
- Made several improvements to the display of tooltips in Signature Help. (#1940, PR: #1958)
-
"omnisharp.path": This option has been updated to enable the user to specify different versions of OmniSharp, including prerelease versions. (#1909, PR: #2039)
Possible values for this option are:
<Path to the omnisharp executable>
: Use a local copy of OmniSharp. The value must point directly to the OmniSharp executable. This is typically the build output directory of the omnisharp-roslyn project on the current machine, for example,C:/omnisharp-roslyn/artifacts/publish/OmniSharp.Stdio/win7-x64/OmniSharp.exe
.latest
: Use the latest CI build from omnisharp-roslyn.<version>
: Use a specific version of OmniSharp. Example:1.29.2-beta.60
If "omnisharp.path" is not set, the defalut version of OmniSharp for the current release of C# for VS Code is used.
-
"omnisharp.useGlobalMono": This option replaces the old "omnisharp.useMono" option and controls whether or not OmniSharp will be launched with a globally-installed version of Mono. (PR: #2244)
There are three possible values:
- "auto": Automatically launch OmniSharp with
mono
if version 5.2.0 or greater is available on the PATH. - "always": Always launch OmniSharp with
mono
. If version 5.2.0 or greater is not available on the PATH, an error will be printed. - "never": Never launch OmniSharp on a globally-installed Mono.
- "auto": Automatically launch OmniSharp with
-
It is now possible to suppress the "Some projects have trouble loading" popup using the
omnisharp.disableMSBuildDiagnosticWarning
option. (#2110
-
Several common globbing patterns are now excluded by default when OmniSharp scans for
*.csproj
,*.cake
, or*.csx
files to load. The deafault patterns are**/node_modules/**/*
,**/bin/**/*
,**/obj/**/*
,**/.git/**/*
. (omnisharp-roslyn#896, PR: omnisharp-roslyn#1161) (Contributed by @filipw) -
The list of globbing patterns that are excluded by OmniSharp can be customized in an
omnisharp.json
file list so.{ "systemExcludeSearchPatterns": [ "**/test/**/*" ], "excludeSearchPatterns": [ "**/local/**/*" ] }
For more details on configuring OmniSharp see Configuration Options at the omnisharp-roslyn repo. (omnisharp-roslyn#896, PR: omnisharp-roslyn#1161) (Contributed by @filipw)
-
Improved handling of projects with XAML files. (#2173, PR: omnisharp-roslyn#1157)
-
MSBuild is now properly located on Windows for Visual Studio 2017 previews. (omnisharp-roslyn#1166) (Contributed by @rainersigwald)
-
It is now possible to define the default target framework for C# scripts in an
omnisharp.json
file.{ "script": { "defaultTargetFramework": "netcoreapp2.0" } }
(PR: omnisharp-roslyn#1154) (Contributed by @filipw)
-
Splits the OmniSharp status bar item into two parts, both of which appear on the left side of VS Code's status bar and have specific responsibilities. (#2146, PR: #2133)
- OmniSharp Server info:
- Displays the current state of the OmniSharp server, such as Downloading, Installing, etc. The flame icon is green when the server is initialized and running properly, or red if there is an error.
- Selected Project info:
- Displays the name of the selected project regardless of the currently active document.
- If a project is already selected, it displays the name of the selected project. Clicking on it displays a menu to switch to other projects in the workspace.
- If there are multiple possible launch targets, it displays 'Select Project'. Clicking on it displays a menu to select one.
- OmniSharp Server info:
- Added "debug all tests" and "run all tests" to the CodeLens that appears above test classes to allow running or debugging all tests in a class. (#420, PRs: #1961, omnisharp-roslyn#1089
- Support for C# 7.2 (PR: omnisharp-roslyn#1055) (Contributed by @filipw)
- Fixes symbol loading while debugging apps running under .NET Core 2.1 (ex: netcoreapp 2.1) on Linux and macOS
- Fixes debug console message encoding issue on Windows (#1775).
- Adds support for extracting source files embedded in PDBs. See the C# EmbeddedFiles feature for more information.
- Adds preliminary support for Linux ARM debugging
- Fix to allow signature help return results for attribute constructors. (#1814, PR: omnisharp-roslyn#1007)
- Fix to return correct SymbolKinds from WorkspaceSymbolprovider (#1907, PR: #1911) (Contributed by @craig006)
- Improved newline formatting in hover info (#1057, PR: #1918)
- Disabled Go To Definition on property acessor keywords (#1949, PR: omnisharp-roslyn#1086)
- Bug fixes to IntelliSense (completion, signature help): ((#1664, 1440, PR: omnisharp-roslyn#1030); (#146 , PR: #1776))
- Improved "Format Code" behavior: (#214, PR: omnisharp-roslyn#1043)
- Improved code action ordering: (omnisharp-roslyn#758, PR: omnisharp-roslyn#1078)
- Fixed duplicate errors in error list (#1830, PR:#1107)
- Addressed problems with projects not being refreshed by OmniSharp after a package restore. (#1583, #1661, #1785, PR: omnisharp-roslyn#1003)
- Added option to disable warning about project.json deprecation (1920, PR: #1926)
- Updated task generator to match latest schema from VS Code (PR: #1932) (Contributed by @natec425)
- Fixed a typo in tasks.json (PR: 1945) (Contributed by @SebastianPfliegel)
- Addressed problem with Sdk-style projects not being loaded properly in certain cases. (#1846, #1849, PR: omnisharp-roslyn#1021)
- Fixed issue with discovering MSBuild under Mono even when it is missing. (omnisharp-roslyn#1011, PR: omnisharp-roslyn#1016)
- Fixed issue to not use Visual Studio 2017 MSBuild if it is from VS 2017 RTM. (omnisharp-roslyn#1014, PR: omnisharp-roslyn#1016)
- Added support for *.cake files! (PRs: #1681, omnisharp-roslyn#932) (Contributed by @mholo65)
- Improved logic for resolving breakpoints in local functions and lambdas. (#1678)
- When generating a new launch.json file via "start debugging" in a workspace without a launch.json file, the extension now provides the same content as is created with the '.NET: Generate Assets for Build and Debug' command. This takes advantage of a new extensibility point from VS Code. Before the C# extension could only statically provide templates, so, for example, they couldn't have the path to the launchable project. (PR: #1801)
- Improved completion list behavior when matching substrings. (PRs: #1813, omnisharp-roslyn#990) (Contributed by @filipw)
- Completion list now triggers on SPACE after
new
. (#146, PR: #1776, omnisharp-roslyn#975)
- Fixed issue with Go to Definition where it was not possible to navigate to a definition within the same file if the file was generated from metadata. (PR: #1772) (Contributed by @filipw)
- Improved symbol search behavior when matching substrings. (PR: omnisharp-roslyn#990) (Contributed by @filipw)
- Significantly changed how MSBuild is located by OmniSharp, resulting in more project types loading properly. (PR: omnisharp-roslyn#988)
- Fixed bug where
LangVersion
property was not read correctly from project file, blocking C# 7.1 development. (omnisharp-roslyn#961, PR: omnisharp-roslyn#962]) (Contributed by @filipw) - Fixed issue where signing key was not read correctly from project file, which can result in InternalsVisibleTo not being handled properly. (PR: omnisharp-roslyn#964)
- Fixed long-standing problem with renaming files. (#785, #1792, PR: #1805)
- Fixed problem where the Antlr4.CodeGenerator Nuget package would not generate files during OmniSharp design-time build. (#1822, PR: omnisharp-roslyn#1002)
- Fixed issue where a C# project referencing a non-C# project would cause the referenced project to be loaded (causing OmniSharp to potentially treat it as C#!). (#371, #1829, PR: omnisharp-roslyn#1005)
- Fix error that occurs when running or debugging tests with latest xUnit 2.3.0 builds. (#1733, omnisharp-rolsyn#944, PR: omnisharp-roslyn#945, #1749)
- Fix issue causing NUnit tests not to work when running or debugging tests. (#1615, PR: #1760). (Contributed by @dgileadi)
- Pass
--no-restore
when invokingdotnet build
to ensure that implicit restore does not run, making the build and the test run a bit faster. (omnisharp-roslyn##942, PR: omnisharp-roslyn#945) - Fix Unit Test debugging with VS Code 1.18. (#1800)
- If Mono 5.2.0 or greater is installed, OmniSharp will be launched on that rather than the local Mono runtime that it carries with it. This allows, more Mono and Xamarin projects to load properly and improves OmniSharp performance (since it can run on Mono AOT'd binaries). (#1779, PR: #1789)
- Support added for launching OmniSharp on folders and solutions across multi-root workspaces. (#1762, PR: #1806)
- Added
csharp.referencesCodeLens.enabled
andcsharp.testsCodeLens.enabled
options to allow disabling/enabling for the 'references' and 'run/debug test' code lenses independently. (#1570, #1807, PRs: #1781, #1809)
- MSBuild support properly sets CscToolExe to 'csc.exe' to address issues when a project's MSBuild targets have set it to 'mcs.exe'. (#1707)
- Update debugger to run itself on .NET Core 2.0-preview2 (target app can still use .NET Core 1.x). This allows the debugger to run on more Linux distributions, and it allows there to be a single debugger package for all supported Linux distributions.
- Fix issue where the call stack may be empty when stepping quickly (#1575)
- Improvements to the information displayed in the editor peak window when stopping on an exception that has inner exceptions (#1007)
- Fix expression evaluation when stopping at an exception in .NET Core 2.0 (#1593)
- Improve error behavior when
"program"
in launch.json is set to a path that doesn't exist (#1634) - Enable stepping by statement (instead of by line) (#1476)
- Go to Definition now works from "metadata as source" files (#771, PR: #1620) (Contributed by @filipw)
- Selection-based code fixes and refactorings (such as "Extract Method") will no longer be offerred unless there is actually a selection in the editor. (#1605, PR: #1606)
- Mono targets and tasks are now better located when Mono is installed. This enables support for many Mono-based projects types, such as Xamarin.iOS, Xamarin.Android, MonoGame, etc. (#1597, #1624, #1396 omnisharp-roslyn#892, PR: omnisharp-roslyn#923)
- Use new solution parer to be more resilient against invalid solution files. (1580, 1645, PRs: omnisharp-roslyn#897 and omnisharp-roslyn#918)
- The MSBuild project system now calls the "Compile" target rather than the "ResolveReferences" target when processing MSBuild files. This has the effect of ensuring that other targets have the opportunity to run (such as targets that generate files) while still not building any output binaries. (#1531)
- Binding redirects added for MSBuild assemblies, fixing issues with MSBuild tasks built with different versions of MSBuild. (omnisharp-roslyn#903)
- The OmniSharp server has updated to the latest MSBuild. (omnisharp-roslyn#904, PR: omnisharp-roslyn#907)
- Support added for referencing NuGet packages in C# scripts. (PR: omnisharp-roslyn#813) (Contributed by @seesharper)
- System.dll is now added correctly for C# scripts targeting .NET Framework. (omnisharp-vscode#1581, PR: #898) (Contributed by @filipw)
- Switched to a new CDN for the extension's dependencies which should deliver an improved download experience (#1542)
- Automatically activate the extension when opening workspaces that contain any .csproj, .sln, or .csx files (#1375, #1150, PR: #1592))
- Added nag message when project.json projects are opened by OmniSharp, to serve as a reminder to migrate projects from project.json to .csproj. (PR: #1657)
- Added
type
property tocsharp.unitTestDebuggingOptions
to allow debugging tests with 'clr' debugger (Windows only). (#1586, PR: #1663) - The
[csharp]
configuration section is now checked for formatting options. (#1574) (Contributed by @filipw) - All project systems (project.json, MSBuild, CSX Scripting) now support an "Enabled" property that can be configured in omnisharp.json. (PR: omnisharp-roslyn#902) (Contributed by @filipw)
- The OmniSharp server has been updated to Roslyn 2.3.0, which adds support for C# 7.1 (PRs: omnisharp-roslyn#900, omnisharp-roslyn#901, omnisharp-roslyn#930 and omnisharp-roslyn#931)
- No longer trigger completion when a '<' character is typed. (#1521, PR: #1530)
- Completion list no longer triggers on space in contexts where a lambda expression could be typed. (#1524, PR: #1548)
- Fixed support for the latest .NET Core 2.0 preview. (#1566)
- Improved download speeds for OmniSharp and Mono dependencies.
- Allow the ".NET: Restore Packages" command to run on projects targeting full framework. (#1507, PR: #1545) (contributed by @adamhartford)
- Several improvements to the completion list! (All contributed by @filipw with PR omnisharp-roslyn#840)
- Attributes are completed properly without the 'Attribute' suffix. (#393)
- Named parameters now appear in the completion list. (#652)
- Object initializer members now appear in the completion list. (#260)
- Completion appears within XML doc comment CREFs.
- Initial support for completion on 'override' and 'partial' keywords. (#1044)
- New VS Code completion item glyphs (e.g. struct, event, etc.) are supported. (PR: #1472) (Contributed by @dopare)
- Updated completion to use same commit characters as Visual Studio. Completion should now complete as non-identifier characters are typed. (#1487, #1491, PR: #1494)
- Project references to projects located outside of the current workspace directory are now loaded and processed. (#963, PR: omnisharp-roslyn#832)
- OmniSharp now loads .NET Core projects using the SDKs included with the .NET Core SDK appropriate for that project, if they're installed on the machine. (#1438, omnisharp-roslyn#765, PR: omnisharp-roslyn#847)
- Options can now be set in an omnisharp.json to specify the Configuration (e.g. Debug) and Platform (e.g. AnyCPU) that MSBuild should use. (omnisharp-roslyn#202, PR: omnisharp-roslyn#858) (Contributed by @nanoant)
- Fixed issue where a package reference would be reported as an unresolved dependency if the reference differed from the intended dependency by case (PR: #861)
- Cleaned up unresolved dependency detection in OmniSharp and added logging to help diagnose project issues. (#1272, PR: #861)
- Support Metadata as Source for Go To Definition in CSX files. (omnisharp-roslyn#755, PR: (omnisharp-roslyn#829) (Contributed by @filipw)
- MSTest support added (#1482, PRs: #1478, omnisharp-roslyn#856) (Contributed by @AbhitejJohn)
- Add support for NUnit Test Adapter. (#1434, PR: omnisharp-roslyn#834)
- Files are saved before running or debugging tests to ensure that recent unsaved changes are included in test runs. (#1473, PR: #1493)
- Tests that define display names are now run properly. (#1426, PR: omnisharp-roslyn#833)
- Tests with similar names are no longer incorrectly run together when one of them is clicked. (#1432, PR: omnisharp-roslyn#833)
- Improve response from running/debugging tests to include output from build and test summary. (#419, #455, PRs: #1436, #1486)
- Added
csharp.unitTestDebugingOptions
setting to pass launch.json-style debug options (example:justMyCode
) when unit test debugging.
- Resolves crash on OSX when the target process loads an embedded PDB (#1456). This commonly affects users trying to debug XUnit tests.
- Enhanced exception peek display to provide additional exception properties.
- New
csharp.suppressHiddenDiagnostics
setting that can be set to true to display hidden diagnostics, such as 'unnecessary using directive'. (#1429, PR: #1435) (Contributed by @cruz82) - Fix issue causing several code snippets to not be available. (#1459, PR: #1461) (Contributed by @shaunluttin)
- Ensure the 'Generate Assets for Build and Debug' command can cause the extension to activate. (PR: #1470)
- The OmniSharp process is now correctly terminated on Unix when the 'Restart OmniSharp' command is invoked. (#1445, PR: #1466)
- Added new
RoslynExtensions
option to allow specifying a set of assemblies in an omnisharp.json file that OmniSharp will look in to find Roslyn extensions to load. (PR: omnisharp-roslyn#848) (Contributed by @filipw)
- Support added for running and debugging unit tests in .csproj-based .NET Core projects. (#1100)
- Arch Linux change: Before, the debugger would automatically use the Ubuntu 16 debugger on Arch. Now we require the debugger to be explicitly set. See https://aka.ms/vscode-csext-arch for more information.
- Several bug fixes that addressed problems with launch (#1335, #1336)
- Fixed several pipeTransport issues including introducing a new
quoteArgs
option (#1318), and fixing attach with Docker (#1369) - Fix issue where VS Code would incorrectly display threads as paused (#1317)
- Added new 'csharp.fallbackDebuggerLinuxRuntimeId' configuration setting to control the version of the debugger used on Linux (#1361).
- Added a new
clr
debuggingtype
in launch.json to enable debugging for Azure scenarios. That type is limited to Windows Desktop CLR, 64-bit processes, and only supports the Portable PDB debug format. - Added support for the launch.json editor's 'Add Configuration' button (#1024)
- Properly handle package references with version ranges in .csproj (PR: omnisharp-roslyn#814)
- Fix regression with MSBuild project system where a project reference and a binary reference could be added for the same assembly, causing ambiguity errors (omnisharp-roslyn#795, PR: omnisharp-roslyn#815)
- If VS 2017 is on the current machine, use the MSBuild included with VS 2017 for processing projects. (#1368, PR: omnisharp-roslyn#818OmniSharp/omnisharp-roslyn#818)
- Fixed null reference exception in DotNetProjectSystem when project reference is invalid (PR: omnisharp-roslyn#797)
-
Added support for global omnisharp.json file (omnisharp-roslyn#717, PR: omnisharp-roslyn#809) (Contributed by @filipw)
This file can appear in one of the following locations:
- Windows:
%APPDATA%\OmniSharp\omnisharp.json
- macOS/Linus:
~/.omnisharp/omnisharp.json
- Windows:
-
Watch local and global omnisharp.json files for changes while OmniSharp is running. Currently, this only works for formatting options. (PR: omnisharp-roslyn#804)(Contributed by @filipw)
-
New 'omnisharp.waitForDebugger' setting to make it easier to debug the OmniSharp server itself. (PR: #1370)
- Improvements made to project.json package completion experience. (#1338)
- Diagnostics are no longer created for hidden diagnostics, addressing the problem of "Remove Unnecessary Usings" spam in the Problems pane. (#1231)
- Improved the extension's runtime dependency download logic to skip re-downloading packages that were already successfully downloaded and installed.
- Assets for building and debugging are now always generated with POSIX style paths. (#1354)
- Don't offer to generate tasks.json if build task already exists. (PR #1363) (Contributed by @eamodio)
Fixes debugging on macOS Sierra 10.12.4.
- Added support for "Go to Implementation" and "Peek Implementation" introduced in Visual Studio Code 1.9. (#37) (Contributed by @ivanz)
- C# scripts (.csx files) now allow multiple
#load
directives, and#r
and#load
directives update live. (omnisharp-roslyn#760) (Contributed by @filipw) - .csx files can now be discovered as valid launch targets using the project selector at the bottom-right of the status bar. (#1247) (Contributed by @filipw)
- Assembly references will now unify properly for C# scripts. (omnisharp-roslyn#764) (Contributed by @filipw)
- Unsafe code is now allowed in C# scripts. (omnisharp-roslyn#781) (Contributed by @filipw)
- C# scripting now ignores duplicated CorLibrary types, which can manifest in certain edge scenarios. (omnisharp-roslyn#784) (Contributed by @filipw)
The 1.8 release makes a major change to how the debugger works under the hood. This new architecture simplifies how the debugger is tied to VS Code. We hope that this will make it easier to bring .NET debugging features to VS Code. We also expect it to improve debugger launch performance.
Changes:
-
The module load messages in the output window are now more detailed and hopefully less confusing. (#837)
-
Programs can now be launched into VS Code's integrated terminal. (documentation)
-
VS Code recently introduced column breakpoint support and they are now enabled for C#.
-
React to the VS Code change to use
${command:
instead of${command.
. (#1275) -
Fix a problem with browser launch support that could lead to debugger session's being aborted when the browser is started. (#1274)
-
Remote debugging breaking changes: as part of our new architecture, there are a few breaking changes to the way remote debugging works.
- vsdbg vs. clrdbg: As part of the new architecture, clrdbg has been replaced with a new executable named vsdbg. As such, the script to download vsdbg has changed to http://aka.ms/getvsdbgsh. Run
curl -sSL https://aka.ms/getvsdbgsh | bash /dev/stdin -v latest -l ~/vsdbg
to download. See the wiki for more information. - Pseudo-tty's are no longer supported: previously we were a little more tolerant of pseudo-tty's transforming the input/output from the remote debugger. We are currently not as tolerant. If you are using
ssh
orplink
as a pipe program, pass-T
to fix this. If you have another transport and you are no longer able to connect, let us know and we can fix this for a future release. debuggerPath
is now required - previously thedebuggerPath
property ofpipeTransport
was recomended but not required. As part of this change we are now requiring it.
- vsdbg vs. clrdbg: As part of the new architecture, clrdbg has been replaced with a new executable named vsdbg. As such, the script to download vsdbg has changed to http://aka.ms/getvsdbgsh. Run
- Find All References now properly highlights locations of found references. (#428)
- Assembly references will now unify properly for project.json projects. (#1221)
- Code Actions (i.e. refactorings and fixes) now respect the formatting options that are set when a project is opened. (omnisharp-roslyn#759) (Contributed by @filipw)
- Completion support for package references in project.json files has been restored. (#1236)
- The C# TextMate grammar used for syntax highlighting has been removed because it is now part of Visual Studio Code itself. (#1206) (Many thanks to @aeschli)
- Introduced a brand new TextMate grammar written from scratch that provides much more robust C# syntax highlighting. (#101, #225, #268, #316, #674, #706, #731, #746, #782, #802, #816, #829, #830, #861, #1078, #1084, #1086, #1091, #1096, #1097, #1106, #1115)
- The C# TextMate grammar has a new home! Issues and contributions are welcome at https://github.com/dotnet/csharp-tmLanguage.
- Updated with the latest changes for .NET Core .csproj projects. (omnisharp-roslyn#738)
- Automatic package restore and out-of-date notifications implemented for .NET Core .csproj projects. (#770)
- Correctly update project when dotnet restore is performed on a .NET Core .csproj project. (#1114)
- Properly handle .csproj projects in .sln files that were added via .NET CLI commands. (omnisharp-roslyn#741)
- Fix
dotnet restore
Visual Studio Code command to execute for .csproj .NET Core projects. (#1175) - Respect
nowarn
in project.json projects. (omnisharp#734) (Contributed by @filipw) - Fix problem with project.json projects that wrap assemblies. (#424)
- Enable debugger support for Zorin OS 12. (#1160) (Contributed by @mkaziz)
- Added off-road support for Windows Subsystem for Linux (NOTE: requires newer version of Windows than have been publicly released yet)
- Fixed issue with debugger pause and multithreaded call stacks (#1107 and #1105)
- Support resolving
#r
references from the GAC. (omnisharp-roslyn#721) (Contributed by @filipw) - Include System.ValueTuple in C# scripts implicitly. (omnisharp-roslyn#722) (Contributed by @filipw)
- Fixed code actions that add files, such as "Move Type to File". (#975)
- Properly surface code actions that have "nested code actions". This allows "generate type" to work properly. (#302)
- Don't display the Remove Unnecessary Usings code action unless it is relevant. (omnisharp-roslyn#742)
- Don't show the Extract Interface refactoring as it requires a dialog that does not exist in VS Code. (#925)
- A namespace icon should be displayed for namespaces in the completion list. (#1125) (Contributed by @filipw)
- Add icons for several symbol kinds in the completion list, fixing many symbols that incorrectly displayed a property "wrench" icon. (#1145)
- Add schema validation for omnisharp.json files. (#1082) (Contributed by @Thaina)
- Add support for auto-closing and surrounding characters. (#749, #842) (Contributed by @filipw)
- Fix running and debugging of tests defined in nested classes. (#743, #1151)
- Fix error when 'tasks.json' does not contain a 'tasks' node, or contains os-specific 'tasks' nodes. (#1140)
- Better detection of Windows architecture (x86 or x64) when determining extension dependencies to download. The detection logic now uses well-known environment variables rather than launching 'wmic'. (#1110, #1125)
- Improvements to the OmniSharp Log (#1155)
- Add new values to the
omnisharp.logginglevel
option to allow more granualar control of OmniSharp logging. (#993) (Contributed by @filipw) - Don't display the "some projects have trouble loading" message if projects only contain warnings. (#707)
- Update Mono detection logic to succeed even if another shell is set as the default (e.g. zsh). (#1031)
- Fix performance issue when editing type names containing multiple generic type parameters. (#1088, #1086)
- Fix crash when tasks.json contains comments. (#1074)
- Roslyn scripting support in CSX files! (#23, omnisharp-roslyn#659) (Contributed by @filipw)
- Support for latest .NET Core .csproj projects updates. (omnisharp-roslyn#705)
- Update 'tasks.json' and 'launch.json' generation to support .NET Core .csproj projects. (#767)
- Properly support
<NoWarn>
in MSBuild projects and specifically ignore theCS1701
warning in .NET Core MSBuild projects. (#967) - Fix global.json-based project search to also the top-level folders specified by the
"projects"
property and not just their children. (#904 and #962)
- Update the debugger so that the debugger itself runs on .NET Core 1.1. This change:
- Enables debugger support for additional Linux distributions - Ubuntu 16.10, openSUSE 42, Fedora 24
- Brings support for running all supported distros on top of Linux Kernel >= 4.6
- Enable debugger support for Arch Linux (#564)
- Improve debugger install errors for macOS without openSSL symlinks (#986), and x86 Windows (#998).
- Improve debugger performance using precompiled debugger binaries (#896)(#971).
- Tons of great syntax highlighting fixes and support! (All contributed by @ivanz)
- Fix for field declarations. (#757)
- Fix for generic types with multiple type parameters. (#960)
- Proper support for interpolated strings (verbatim and non-verbatim). (#852)
- Fix for multi-line properties. (#854)
- Fixes for events, nested type references (e.g.
Root.IInterface<Something.Nested>
), variable declarations, nested classes, and fields spanning multiple lines
- Improve display of hover tool tips for built-in C# types, such as
int
andstring
. (#250) (Contributed by @filipw) - Improve display of hover tool tips for nested classes. (#394) (Contributed by @filipw)
- Fix spacing in hover tool tips around
<paramref/>
in XML doc comments. (#672) (Contributed by @filipw)
- Support for running/debugging NUnit tests (#996) (Contributed by @HexWrench)
- Fix exception thrown when sending
/autocomplete
request to OmniSharp server in location where no completion items are available. (#980) - Add
omnisharp.maxProjectResults
setting to control the maximum number of projects to display in the 'Select Project' dropdown. The default is 250. (#875) (Contributed by @filipw) - Fix signature help display for constructors. (#36) (Contributed by @filipw)
- Ensure that the
editor.insertSpaces
andeditor.tabSize
settings are passed to OmniSharp for formatting. Note that this behavior can be controlled with theomnisharp.useEditorFormattingSettings
option, which defaults to true. (#1055) (Contributed by @filipw)
- Use value of
http.proxyStrictSSL
even whenhttp.proxy
is not set. (#957)
- Ensure diagnostics are cleared in files when they are no longer needed. (#858)
- Enqueue requests for diagnostics in visible editors when the extension starts up. (#843)
- Provide fallback URLs for debugger downloads. (#930)
- Properly require .NET Framework 4.6 in the OmniSharp.exe.config file to ensure that the user is displayed a dialog on Windows machines that don't have .NET Framework 4.6 installed. (#937)
- Fix issue with installing on non-English installations of Windows. (#938)
- Display platform information when acquiring runtime dependencies. (#948)
- Fix to properly support
http.proxy
andhttp.proxyStrictSSL
settings. (#930)
- New C# 7 features like pattern-matching and tuples are now supported in VS Code editor. Note: To use tuples, you will need a reference to this NuGet package.
- With the .NET Core SDK moving to embrace MSBuild and .csproj files over project.json, we've made sure the C# extension can handle the new format. This support is preliminary and there are still several features coming to smooth out the experience.
-
This release dramatically changes the runtime that OmniSharp runs on, which allows it to be run an many more operating systems than before:
- Windows: OmniSharp runs on the installed .NET Framework. In addition, OmniSharp now runs on 32-bit Windows!
- macOS/Linux: OmniSharp runs on a custom embedded Mono runtime. Note: Mono does not need to be installed on the system for this to work.
- Remote debugging is now supported for attach by using the
pipeTransport
launch.json option. - Resolved issue with setting breakpoints when there are multple files with the same name (e.g. two 'Program.cs' files).
- This improves the acquisition and reliability of platform-specific OmniSharp and debugger dependencies.
Several new settings have been added:
csharp.suppressDotnetRestoreNotification
: Suppress the notification window to perform a 'dotnet restore' when dependencies can't be resolved.omnisharp.projectLoadTimeout
: The time Visual Studio Code will wait for the OmniSharp server to start. Time is expressed in seconds. (Contributed by @wjk)
- A new unit testing framework for testing the colorizer grammer (#742) (Contributed by @ivanz)
- Single-line comments after preprocessor directives (#762) (Contributed by @damieng)
- Major improvements have been made to editor performance. The communication with the OmniSharp server has been rewritten to allow long-running operations (such as gathering all errors and warnings) to queue while high priority operations (such as text buffer changes) run serially. (#902) (Thanks to @david-driscoll for his help with this change!)
- The prompt to generate assets for building and debugging can now be dismissed for a workspace permanently. In addition, a new
dotnet.generateAssets
command has been added to force regeneration of the assets. (#635) - Fix "running forever" issue for folder with multple .NET Core projects. (#735) (Contributed by @eamodio)
ctor
snippet is now more consistent with other code snippets. (#849) (Contibuted by @Eibx)- Ampersands in file paths are now properly escaped on Windows (#909) (Contributed by @filipw)
- This addresses an issue found and fixed by @sixpindin in which the legacy csharp.omnisharp and csharp.omnisharpUsesMono settings are no longer respected. These settings have been supplanted by the omnisharp.path and omnisharp.useMono settings but are still expected to work if specified.
- Go to Definition (F12) can now show a C#-like view for APIs that do not appear in your project's source code. (#165)
- Applications can now be launched without attaching the debugger with Ctrl+F5.
- Support for new "embedded portable PDB" debug format.
- The launch.json file generator now automatically sets the option to show a console window by default (
"internalConsoleOptions": "openOnSessionStart"
).
Several new settings have been added:
csharp.suppressDotnetInstallWarning
: Suppress the warning that the .NET CLI is not on the path.omnisharp.autoStart
: Used to control whether the OmniSharp server will be automatically launched when a folder containing a project or solution is opened. The default value for this setting istrue
.omnisharp.path
: Can be used to specify a file path to a different OmniSharp server than the one that will be used by default. Previously, this option was controlled bycsharp.omnisharp
, which is now deprecated.omnisharp.useMono
: Whenomnisharp.path
is specified, this controls whether OmniSharp will be launched with Mono or not. Previously, this option was controlled bycsharp.omnisharpUsesMono
, wich is now deprecated.omnisharp.loggingLevel
: Used to control the level of logging output from the OmniSharp server. Legal values are"default"
or"verbose"
.
There have been several fixes to the colorizer grammar resulting in much smoother syntax highlighting, with better support for C# 6.0. Special thanks go to @ivanz and @seraku24 for contributing most of the fixes below!
- Expression-bodied members (#638, #403, #679, #249)
- Escaped keyword identifiers (#614)
- Using directives and nested namespaces (#282, #381)
- Field and local variable type names (#717, #719)
- Multi-dimensional arrays in parameters (#657)
- Improvements have been made in processing diagnostics (i.e. errors and warnings).
- Full solution diagnostics are no longer computed for large solutions (e.g. solutions with >1000 files across all projects). However, diagnostics are still computed for open files.
- Multibyte characters are now properly encoded, resulting in proper display in tooltips and fixing crashes in the OmniSharp server. (#4, #140, #427)
- Will no longer attempt to install a CoreCLR flavor of OmniSharp on Ubuntu versions other than 14 and 16. (#655)
- Opening a solution or csproj no longer results in '0 projects' displayed in the status bar. (#723)
- Support for Unity and Mono development on macOS and Linux has been restored! This release brings back support for the Mono version of OmniSharp, which is used to provide much better support for .csproj/.sln projects. Please note that Mono version 4.0.1 or newer is required.
- Generation of tasks.json and launch.json files can now properly handle nested projects. #170
- New UI that makes it easy to select a process ID when attaching the debugger to another process. Note: If you have an existing launch.json file, you can re-generate it by deleting the file, closing your workspace in Visual Studio Code and opening it again. Or, you can open the launch.json file and change the
processId
value to"${command:pickProcess}"
. - Support for debugging in .cshtml files. To enable this, add a
sourceFileMap
entry to your launch.json with the following content:"sourceFileMap": { "/Views": "${workspaceRoot}/Views" }
- Support for conditional breakpoints
- New support for changing variable values in the debugger! To try this, just right-click on the variable name and select 'Set Value'. Note: To properly support this feature, we've changed the display of variable type names in the debugger to a shortened form. The full type name can be viewed by hovering over the name with the mouse.
- New configuration option to enable stepping into properties and operators.
- Duplicate warnings and errors should no longer accumulate in Unity projects #447
- Adds debugger support for new Linux versions: Ubuntu 16.04, Fedora 23, openSUSE 13.2, and Oracle Linux 7.1
- Enhanced debug console output: module loads are now output, and there are launch.json options for controlling what is output
- Source file checksum support for breakpoints. This ensures that the debugger only sets breakpoints in code that exactly matches the open document.
- Support for editing the value of variables in the watch and locals window (requires VS Code 1.3)