0

興味深いものを持っています。C# で XML ドキュメント コメントを使用してメソッドをドキュメント化しています。ディレクティブを使用して、参照ファイルのすべてのコンテンツを含めたいと考えています。xml ドキュメントとしてフォーマットされた文字列を受け取るコードをドキュメント化しています。パラメータ ドキュメントに XSD ファイルを含めたいと考えています。

これは、Visual Studio によって生成された XML が期待どおりであるため、正常に機能します。XML のスニペットを次に示します。

    /// <param name="xml">XML string - see Test.xsd <include file="XSD/Test.xsd" path="/*"/> After file include</param>

ただし、Sandcastle を使用してこれからヘルプ ファイルを生成すると、xsd ファイルの内容は表示されませんが、Sandcastle はエラーを報告しません。私は、ヘルプファイルがある場所にも相対的なファイル名を使用しようとしました。

しかし、その後、Visual Studio はファイルが見つからないと不平を言います。それらを両方の場所に配置しましたが、含まれているファイルは表示されません。

何か案は？

4

1 に答える 1

0

include タグはコンパイル時に処理されるため、生成された XML ファイルには、参照されているすべてのコンテンツが含まれている必要があります。したがって、XSD フォルダーを C# ソース ファイルに相対的に配置する必要があります。そうすれば、コンパイラーはエラーを表示しません。この後、Sandcastle は単一の XML ドキュメントからヘルプ ファイルを作成できるようになります。

于 2012-03-01T21:09:52.607 に答える