3 '/'は連続してC＃で何をするのですか？

Question

私は突然私がコメントに3'd '/'をタイプしたときにララの土地に沿ってコーディングしていました。もともとのコメントは2 '/' sのでグリーンを行く：

しかし、第三ダッシュで、それはグレー '///' を行く：

具体的な意味はありますか？それとも色が変わったのか？

Answer 1

これはXmlCommentを表し、その詳細はMSDNで読むことができます。例えば、

/// <summary> 
/// Method summary - a method that does something 
/// </summary> 
/// <param name="i">Description of param</param> 
/// <param name="s">Description of param</param> 
/// <returns>An object of some sort or other</returns> 
public object AMethod(int i, string s) 
{ 
} 

編集：以下の提案として、以下の画像が示すように、それはまた、IntelliSenseガイダンスを提供します。

Answer 2

スリースラッシュのコメントはドキュメントビルダーのためのものです。ソースから直接APIのドキュメントを生成することができます。あなたのAPIが何をしているか、どのパラメータをとるか、例外がスローされるかなどをあなたのソースに書かせることができます。 Microsoftは、ドキュメントが実際のAPIと同期していることを確認するためのツールを提供しています。たとえば、パラメータの追加、削除、または名前の変更を文書化するのを忘れた場合は、警告が表示されます。

Visual Studioを使用してこれらのタグからドキュメントを生成する方法は、linkです。

Answer 3

///はXMLコメント用です。 XML形式のコメントを提供します。

csc /doc:filedoc.xml program.cs