In MonoDevelop, when I type "///", it auto-generates an xml-style comment like this:
/// <summary> /// Describes the variable x /// </summary> int x = 0;
Is there a way to get this behavior in Visual Studio Code?
An XML comment encountered outside the document type declaration is represented by the Comment value syntax element. It contains the comment text from the XML message. If the value of the element contains the character sequence --> , the sequence is replaced with the text --> .
C# documentation comments use XML elements to define the structure of the output documentation. One consequence of this feature is that you can add any valid XML in your documentation comments. The C# compiler copies these elements into the output XML file.
XML documentation comments - document APIs using /// comments | Microsoft Docs.
This feature is not available out-of-the-box with VS Code, but like most features is available via third-party extensions. As of the time of this answer, here is a popular extension that provides some XML comments support to VS Code:
C# XML Documentation Comments Support for Visual Studio Code
If that extension doesn't work for you, you may be able to find alternatives by searching the VS Code Marketplace
Starting with C# for Visual Studio Code Extension 1.23.8 this is suppored when Editor: Format On Type.
setting is enabled.
This can be found in the menu under File/Preferences/Settings/Text Editor/Formatting
.
If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!
Donate Us With