2010-07-13 8 views
6

Tengo un servicio de WCF y comentando mis contratos de operación de la siguiente manera:XML Los comentarios no aparecen en el Servicio 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); 

Sin embargo los comentarios XML que estoy poniendo en el 3 por encima de la barra normal /// no aparecen en la información sobre herramientas en mi aplicación cliente que lo consume, ¿es esta funcionalidad estándar del servicio web/WCF? ¿Nunca aparecerán? O hay una forma de hacer que aparezcan?

Respuesta

6

Los comentarios de Xml Doc generalmente no están integrados en el WSDL generado para un servicio WCF. Esta información generalmente solo está disponible cuando el archivo de documentación xml apropiado está ubicado junto con un ensamblaje directamente referenciado.

La única información que se incluye en un WSDL generado (o metadatos proporcionados por un punto final MEX) son las propiedades de los atributos del contrato. Consulte la documentación de la siguiente:

+1

THanks, ¿Hay alguna forma de colocar el XML con el cliente haciendo referencia a él? ¿Forzarlo de alguna manera? – David

+0

El XML solo se usa si coincide directamente con el ensamblado que lo generó. Podrías dejarlo en la carpeta bin de tu cliente, pero no hará nada. Puede cambiar el nombre del archivo para que coincida con el .dll que contiene el proxy WCF del cliente. Los tipos de proxy estarán en diferentes espacios de nombres, y no coincidirán directamente con los tipos de origen, por lo que no hay garantías. – jrista

+1

Esto es una verdadera lástima ... Me pregunto si hay alguna manera de extender el proceso que genera el Reference.cs para también detener los comentarios. – Kritner

Cuestiones relacionadas