4

mainC# では、メソッドの XML コメントを書きました。

/// <summary>
/// Some comment.
/// </summary>
public static void Main(string[] args)
{

しかし、Visual Studio はそれに対して私に警告します:

XML comment is not placed on a valid language element main

mainC# でメソッドにコメントする推奨される方法は何ですか?

4

3 に答える 3

2

パラメータにもコメントを付ける必要があると思います。

/// <summary>
/// 
/// </summary>
/// <param name="args"></param>
static void Main(string[] args)
{

これがVSが探しているものだと思います。メソッドを記述したら、メソッドの///上にタイプするだけです。少なくとも私のVisual Studioではエラー/警告は出ません。

それが役に立てば幸い。

于 2013-07-18T10:20:51.730 に答える
2

特定の言語要素には、名前空間などの xml ドキュメントを含めることは許可されていません。この場合は明らかにメイン メソッドも含めてください。ドキュメントにはこれが記載されており、他の XML のすべきこととすべきでないことを示すリンクもいくつかあります。

私が提案できる唯一のハッキーな答えは、コメントしたい場合は、トリプルの代わりにダブルクォーテーション // を使用することです。トリプルはクラスのドキュメントに処理され、バックグラウンドの問題を引き起こしている可能性があります。

于 2013-07-18T10:36:42.260 に答える
1

その上で提案を加えたいと思います。XML ドキュメントの作成を開始する前に、プロジェクトのプロパティ -> [ビルド] に移動し、XML ドキュメント ファイルを示すチェック ボックスをオンにします。これは、XML タグを記述する際に役立ちます。名前空間の上など、無効な XML タグを配置すると、VS は次のように表示します: XML コメントは有効な言語要素に配置されていません。

于 2016-10-06T14:59:14.680 に答える