皆さん、
新しい WCF サービスを作成していて、サービス インターフェイスから始めました。次のようになります。
public interface ISomethingService
{
/// <summary>
/// some description
/// </summary>
/// <version>2.13.0</version>
/// <copyright>2009 by myself</copyright>
/// <author>Marc Scheuner</author>
/// <param name="request">The request object</param>
[OperationContract]
SomethingResponse GetList(SomethingRequest request);
}
ここで、SomethingRequest および SomethingResponse メッセージを記述した別のファイルにデータ コントラクトもいくつか作成しました。
プロジェクトをコンパイルし、svcutil.exe を起動して DLL からメタデータ (WSDL および XSD) を抽出しましたが、すべてのコメントと説明を WSDL/XSD に取得して / に入れる方法があるかどうかわかりません。ノード。
さらに別のあいまいな svcutil.exe パラメーターがわかりませんか、それともメタデータでこのドキュメントを自動的に生成する方法は本当にありませんか??
編集: わかりました、Marc Gravell の回答に基づいて、コメントとドキュメント文字列はコンパイルされた DLL にも、MEX メタデータ交換プロトコル (残念!) 経由でも利用できません。
SO THEN: サービスにアクセスするために必要な情報をサードパーティに提供する必要がある場合、WCF サービスをどのように文書化しますか?? 私のWCFサービスライブラリをスキャンし、アノテーションを含むソースコードからWSDLとXSDを構築する「NService」または「WCF用サンドキャッスル」ツールはありますか??
これを行うためのツールや方法がたくさんあるようには見えません - 正直なところ、私の大きな驚きに....
マルク