問題タブ [xml-comments]

再フォーマットしたい次のフォーマットの XML があります。

私の問題は、各ブロック タグの上にあるコメントを選択する方法がわからないことです。次の XSL があります。

私がしようとしている出力は次のとおりです。

=== りんご ===
block1
=== バナナ ===
block2
=== オレンジ ===
block3

しかし、私が得ることができる最高のものは次のとおりです。

=== リンゴ ===
=== バナナ ===
===オレンジ === ブロック 1 === リンゴ === === バナナ === === オレンジ === ブロック 2 === リンゴ == = === バナナ === === オレンジ === block3

それが違いを生む場合、私はPHPを使用しています。

私は現在プログラミングの学生であり、明らかに私の質問は単純ですが、オンラインでその答えを見つけることができませんでした。だからここにあります：

タグが表示されるC＃のXML ///コメントでは、メソッド呼び出しの上にマウスを置くと <returns>、タグに含まれるすべてのものがインテリセンスで表示されますが、returnsタグは表示されません。<summary>

では、<returns>タグはどこから入ってくるのでしょうか？

ありがとう。

クラスとインターフェイスを文書化する際のベスト プラクティスは何ですか。IFoo というインターフェイスから派生する Foo という具象クラスがあるとします。メソッドについてのコメントはどこに置きますか? インターフェイスと具体的なクラスに関するコメントを複製しますか?

コメントが重複している例を次に示します。

別のアプリケーションのApp.configファイルの単純なAppSettingを変更し、変更を保存できる小さなユーティリティを作成しました。

これは、1つの副作用を除いて、うまく機能します。新しく保存された.configファイルは、元のXMLコメントをすべて失いますが、AppSettings領域内でのみ失われます。元の構成ファイルのAppSettings領域からXMLコメントを保持することは可能ですか？

すばやくコンパイルして実行したい場合は、完全なソースのペーストビンを次に示します。

Visual Studioの「note」などのXMLコメントのキーワードをエスケープするにはどうすればよいですか？

例えば

「note」という単語の後のテキストを青くしたくありません。

これはResharper機能である可能性があることに注意してください。

すべてのXml-CommentingがIntellisenseに表示されるわけではないようですが、おそらく正しく実行されていませんか？とにかく、列挙リスト内の個々の列挙メンバーが説明テキストとともにインテリセンスで表示されるようにしようとしています。たとえば、String.Splitメソッドでは、次のように、3番目のオーバーロードがStringSplitOptions列挙をパラメーターとして受け取ります。

代替テキストhttp://www.freeimagehosting.net/uploads/a138d36615.jpg

私が試した他のことの中で：

上記の例は機能しますが、最初の列挙に対してのみ機能し、他の列挙に対しては機能しません。

私が間違っていることは何ですか？

これで、次のようなメソッド コメントを定義する方法がわかります。

これをコードで取得する方法はありますか。これは、.cs ファイルを解析することを意味するのではなく、実際に取得して使用できるようにすることを意味します。何かのようなもの

前もって感謝します！

T4テンプレートを使用してインターフェイスからクラスを生成していますが、インターフェイスからクラスメソッドにxml-commentsをコピーできるようにしたいと考えています。それは可能ですか？もしそうなら、どのように？

私のテンプレートでは、インターフェイスメソッドを取得して次のようにコピーしています。

このようなコードでコメントを書くことに意味はありますか?

Visual Studio では、インテリセンスにクラス メンバーの各タイプ (フィールド、プロパティなど) のアイコンがあるため、この意味がわかりません。私の現在のショップでは、これらのアイコンを提供する Visual Studio のみを使用しています。

ありがとう