3

皆さん、

新しい 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用サンドキャッスル」ツールはありますか??

これを行うためのツールや方法がたくさんあるようには見えません - 正直なところ、私の大きな驚きに....

マルク

4

2 に答える 2

3

svcutil.exe は "mex" API を使用し、メタデータのサブセットにしかアクセスできません。コメントは含まれていません (また、IIRC[DescriptionAttribute]も大部分は含まれていません)。

外部ドキュメント (つまり、ヘルプ ページ/デッド ツリー) に依存する必要がある場合があります。もう 1 つのオプション (多くの純粋な SOA 規則に違反しますが) は、エンティティ/インターフェイスを dll + xml で出荷することです。svcutil (および IDE) は、既存のアセンブリから一致する型を再利用できます。

于 2009-03-12T15:35:10.317 に答える
0

たぶんこれが役立ちます: http://msdn.microsoft.com/en-us/library/aa717040.aspx

svcutil でも動作します。

于 2009-11-27T16:11:17.963 に答える