XMLコードに参照コメントを追加する方法

このステップバイステップガイドで事実を確認する

XMLコードに参照コメントを追加する方法については、このステップバイステップのチュートリアルを参照してください。 5分でこの機能を実行する方法を学ぶことができます。 このプロセスは簡単ですが、始める前にXMLコメントとその有用性についての基本的な知識があります。

XMLコメントが有用な理由

XMLのコメントは、HTMLのコメントとほぼ同じです。両方の構文が同じであるためです。 コメントを使用すると、何年も前に書いたコードを理解することができます。 また、開発したコードをレビューしている別の開発者が、あなたが書いたことを理解するのに役立ちます。 要するに、これらのコメントはコードの文脈を提供します。

コメントを付けると、簡単にメモを残したり、XMLコードの一部を一時的に削除することができます。 XMLは「自己記述型データ」として設計されていますが、XMLコメントを残す必要がある場合があります。

入門

コメントタグは、コメント開始する部分と終了する部分の2つの部分で構成されます。 開始するには、コメントタグ<! - の最初の部分を追加します。次に、コメントを書いください。 他のコメントの中にコメントを入れないようにしてください(詳細はヒントを参照してください)。

その後、コメントタグを閉じる - >

役に立つヒント

XMLコードに参照コメントを追加するときは、ドキュメントの最上部に参照コメントを付けることはできません。 XMLでは、XML宣言だけが最初に来ることができます:

<?xml version = "1.0"?>

上で述べたように、コメントは別のものの中に入れ子にされることはできません。 最初のコメントを閉じる前に、最初のコメントを閉じる必要があります。 また、 のように、タグ内ではコメントは発生しません。

コメントの最初と最後には、2つのダッシュ( - )を使用しないでください。 コメントの中の何かはXMLパーサーには見えませんので、残っているものはまだ有効で整形式であることに十分注意してください。

ラッピング

XMLコードに参照コメントを追加することについてまだ疑問がある場合は、書籍がどのように機能するかを詳細に把握したい場合があります。 Rod Stephens のC#5.0 Programmer's Referenceなどの書籍が参考になるかもしれません。 類似の書籍については、オンライン小売店または地域の図書館で確認してください。