XML-Kommentare werden im WCF-Dienst nicht angezeigt

Question

Ich habe einen WCF-Dienst und kommentiert meine Operation Verträge wie unten:

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

Jedoch die XML-Kommentare, die ich in die 3 Schrägstriche wie oben /// setzen, erscheinen nicht in den QuickInfos in meiner Client-Anwendung, die es verbraucht, ist dies Standard WCF/Web-Service-Funktionalität? Werden sie nie erscheinen? ODER gibt es eine Möglichkeit, sie erscheinen zu lassen?

Answer 1

Xml-Doc-Kommentare werden im Allgemeinen nicht in die generierte WSDL für einen WCF-Dienst integriert. Diese Informationen sind in der Regel nur dann verfügbar, wenn die entsprechende Xml-Dokumentationsdatei zusammen mit einer direkt referenzierten Assembly platziert ist.

Die einzigen Informationen, die in einer generierten WSDL (oder in den von einem MEX-Endpunkt bereitgestellten Metadaten) enthalten sind, sind die Eigenschaften der Vertragsattribute selbst. Prüfen Sie die Dokumentation auf die folgenden Informationen:

• Dienstleistungsvertrag
• OperationVertrag
• DatenVertrag
• DataMember
• NachrichtenVertrag
• MessageHeader
• MessageBodyMember
• FaultContract