جعل svcutil التقاط الوثائق من الملفات # C؟

Question

والناس،

وأنا خلق خدمة 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 لاستخراج البيانات الوصفية (WSDL وXSD) من DLL - لكنني لا يمكن أن يبدو لمعرفة ما اذا كان هناك طريقة للحصول على كل تعليقاتي والتفسيرات في WSDL / XSD إلى / العقد.

وأنا أعمى عن بعد المعلمة svcutil.exe غامضة أخرى، أم أن هناك حقا أي وسيلة لتوليد هذه الوثائق في البيانات الوصفية تلقائيا ؟؟

وتحرير: طيب، على أساس الجواب مارك Gravell والتعليقات وسلاسل وثائق ليست سواء في DLL المترجمة، ولا تتوفر على MEX بروتوكول تبادل البيانات الوصفية (شفقة!)

.

وحتى ذلك الحين: كيف توثق خدمات WCF الخاص بك، إذا كنت بحاجة إلى إعطاء الطرف الثالث على المعلومات التي يحتاجون إليها للوصول إلى الخدمة الخاص بك ؟؟ هل هناك أداة "NService" أو "القلعة الرملية لتمويل رأس المال العامل" حول من شأنها أن تفحص مكتبتي خدمة WCF وبناء WSDL وXSD من شفرة المصدر، بما في ذلك شروح ؟؟

لا يمكن العثور على ما يبدو مجموعة كبيرة من الأدوات والطرق للقيام بذلك - لدهشتي كبيرة، وبصراحة ....

ومارك

Answer 1

وsvcutil.exe يستهلك "المكسيك" API، وليس لديها سوى الوصول إلى مجموعة فرعية من البيانات الوصفية. ليست مدرجة تعليقات (ولا، IIRC، و[DescriptionAttribute] إلى أي حد كبير).

وقد تضطر إلى الاعتماد على وثائق الخارجية (أي صفحة مساعدة / شجرة ميتة). واحد خيار آخر (على الرغم من وقوع عدد من القواعد SOA النقي) هو لشحن الكيانات / واجهات في دلل + أكس. svcutil (وIDE) يمكن إعادة استخدام مطابقة أنواع من المجالس القائمة.

Answer 2

وربما هذا يساعد على: http://msdn.microsoft.com/en-us/library/aa717040. ASPX

وكان يعمل مع svcutil كذلك.