2010-07-13 10 views
6

Ho un servizio WCF e commentando i miei contratti di gestione, come di seguito:XML commenti non appaiono nelle servizio WCF

/// <summary> 
    /// Call to topup a card. 
    /// </summary> 
    /// <param name="topUp">The TopUp object which specifies the card to topup.</param> 
    /// <returns>Returns a boolean indicating whether call has finished successfully.   </returns> 
    [OperationContract] 
    bool UploadTopUp(TopUp topUp); 

Tuttavia i commenti XML sto mettendo in 3 slash come sopra /// non appaiono nelle descrizioni dei comandi nella mia applicazione client che lo consuma, è questa funzionalità WCF/web service standard? Non appariranno mai? O c'è un modo per farli apparire?

risposta

6

I commenti Xml Doc non sono generalmente integrati nel WSDL generato per un servizio WCF. Queste informazioni sono solitamente disponibili solo quando il file di documentazione xml appropriato è collocato con un assembly referenziato direttamente.

Le uniche informazioni incluse in un WSDL generato (o metadati forniti da un endpoint MEX) sono le proprietà degli stessi attributi del contratto. Controllare la documentazione per il seguente:

+1

THanks, C'è un modo per colocare l'XML con il client che lo fa riferimento? Forzalo in qualche modo? – David

+0

L'XML viene utilizzato solo se corrisponde direttamente all'assieme che lo ha generato. Puoi rilasciarlo nella cartella bin del tuo client, ma non farà nulla. Potrebbe essere possibile rinominare il file in modo che corrisponda al file .dll che contiene il proxy WCF del client. I tipi di proxy si troveranno in diversi spazi dei nomi e non corrisponderanno direttamente ai tipi di origine, quindi non ci sono garanzie. – jrista

+1

Questo è un vero peccato ... Mi chiedo se c'è un modo per estendere il processo che genera Reference.cs anche per trascinare i commenti. – Kritner