Asigurați-svcutil ridica documentația de la C # fișiere?

voturi
2

oameni buni,

Sunt crearea unui nou serviciu WCF și a început cu interfata mea de service. Se pare ceva de genul:

   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);
    }

Acum, am creat, de asemenea, unele contracte de date într-un alt dosar care descrie mesajele SomethingRequest și SomethingResponse.

Am compilat proiectul meu și tras în sus svcutil.exe pentru a extrage metadatele (WSDL și XSD) din DLL - dar nu pot par să dau seama dacă există o modalitate de a obține toate comentariile și explicațiile mele în WSDL / XSD în / noduri.

Sunt orb pentru încă un alt parametru svcutil.exe obscur, sau este într-adevăr nu există nici o modalitate de a genera această documentație în metadatele automat ??

EDIT: OK, în funcție de răspunsul lui Marc Gravell lui, comentariile și șirurile de documentare nu sunt în nici DLL compilate, nici disponibile pe Mex protocolul de schimb de metadate (mila!).

SO APOI: Cum documentați serviciile WCF, dacă aveți nevoie pentru a da o terță parte informațiile de care au nevoie pentru a avea acces la serviciul ?? Există un instrument „NService“ sau „Sandcastle pentru WCF“ în jurul valorii de care ar scana biblioteca mea WCF și construi WSDL și XSD de la codul sursă, inclusiv adnotările ??

Nu pot par să găsească o mulțime de instrumente și modalități de a face acest lucru - spre surprinderea mea mare, sincer ....

tescovină

Întrebat 12/03/2009 la 14:25
sursa de către utilizator
În alte limbi...                            


2 răspunsuri

voturi
3

svcutil.exe consumă „Mex“ API - ul, și are acces la un subset al metadatelor numai. Comentariile nu sunt incluse ( și nici, IIRC, este [DescriptionAttribute]o măsură mare).

S-ar putea să se bazeze pe documentația externă (de exemplu, o pagină de ajutor / copac mort). O altă opțiune (deși se rupe un număr de reguli SOA pur) este de a navei entitățile / interfețele într-un dll + xml; svcutil (și IDE) pot reutiliza tipuri de potrivire a ansamblurilor existente.

Publicat 12/03/2009 la 14:35
sursa de către utilizator

voturi
0

Poate că acest lucru ajută: http://msdn.microsoft.com/en-us/library/aa717040.aspx

Acesta funcționează cu svcutil, de asemenea.

Publicat 27/11/2009 la 15:11
sursa de către utilizator

Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more