Source.GetCommentFormat Source.GetCommentFormat Source.GetCommentFormat Source.GetCommentFormat Method

Definition

Gets information on what defines a comment in the language.

public:
 virtual Microsoft::VisualStudio::Package::CommentInfo GetCommentFormat();
public virtual Microsoft.VisualStudio.Package.CommentInfo GetCommentFormat ();
abstract member GetCommentFormat : unit -> Microsoft.VisualStudio.Package.CommentInfo
override this.GetCommentFormat : unit -> Microsoft.VisualStudio.Package.CommentInfo
Public Overridable Function GetCommentFormat () As CommentInfo
Returns

A CommentInfo structure containing the strings that define a comment.

Remarks

To support adding comments to and removing comments from source code, the Source class needs to know what defines a line comment (runs from the line comment characters to the end of the line) and block comment (runs from the start block comment characters to the end block comment characters, often spanning multiple lines). This method provides that information. If your language does not use the C#/C++ format for comments, then you must derive a class from the Source class and override this method to provide the appropriate comment delimiters.

The base method creates a new CommentInfo and fills it in with C#/C++ line and block comment delimiters, specifically, "//", "/*", and "*/". The base method also indicates that line comments can be used.

Applies to