1

インライン XML ドキュメント (つまり、3 つのスラッシュを使用する - ///) が機能しない理由は理解できたと思いますが、「問題」を回避する方法についていくつかのガイダンスを得たいと思います。

インターフェイスと 2 つの派生クラスがあります。派生クラスの 1 つはシミュレーション用で、もう 1 つは実際のハードウェアとの通信用です。

シミュレーターが行う必要のない特別なことをハードウェア実装が行う可能性が非常に高いです。シミュレーター用ではなく、ハードウェア メソッド用の XML ドキュメントがあります。ただし、メソッド名にカーソルを合わせると、ツールチップにドキュメントがまったく表示されません。これは、おそらく XML ドキュメントがインターフェイスに関連付けられていないためです。

これは確かに理にかなっており、代わりにドキュメントをインターフェイスに配置して、それと一緒に暮らす予定です。私はまだ興味がありますが、他の人はどのようにこれを行うのですか? ツールチップにすべての有効な XML ドキュメントを集約させる魔法のような方法はありますか? つまり、コンパイラはどの派生クラスが使用されているかを認識していないため、このインターフェイスを実装するすべてのクラスの XML ドキュメントを表示する方法はありますか?

4

2 に答える 2

0

これですべての問題が解決するわけではありませんが、GhostDocは、基本クラスのドキュメントを使用して、派生クラスにドキュメントをすばやく挿入できます。XMLドキュメントを作成している場合は、とにかく一見の価値があります。

于 2011-05-11T14:40:31.537 に答える
0

インターフェイスに対してプログラミングしているため、実装から XML ドキュメントを渡す方法はありません。分離は、2 つの「側」が互いのことを知らないことを意味します。あなたが言ったように、そのインターフェースの2つの異なる実装を持つことができます。その場合、競合が発生します。2人なら大したことないけど、200人ならどうする？さらに、インターフェースを使用するポイントは、それがどのように実装されているかを気にしないことです。インターフェイスを使用して呼び出すと、実装がコントラクトに従うことがわかります。インターフェイスの XML コメントを使用して、コントラクトの実装ではなく、コントラクトを記述します。

私はこれであなたの痛みを感じることができます。より良い解決策があるかどうかはわかりません.

于 2011-05-11T14:36:40.820 に答える