2010-07-13 3 views
6

У меня есть службы WCF и комментируя свои операции контракты, как показано ниже:XML комментарии не отображаются в службе 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); 

Однако XML комментарии Я кладу в 3 слэша, как указано выше /// не появляются в подсказках в моем клиентском приложении, которое его потребляет, является ли эта стандартная функциональность WCF/веб-службы? Неужели они никогда не появятся? ИЛИ есть способ заставить их появиться?

ответ

6

Xml Замечания Doc, как правило, не интегрированы в сгенерированный WSDL для службы WCF. Эта информация обычно доступна только в том случае, если соответствующий файл документации xml размещен совместно с сборкой, непосредственно связанной с ней.

Единственная информация, которая включена в сгенерированный WSDL (или метаданные, предоставленные конечной точкой MEX), является свойствами самих атрибутов контракта. Проверьте документацию для следующих условий:

+1

Чтец, есть ли способ объединить XML с клиентом, ссылающимся на него? Заставить это как-то? – David

+0

XML используется только в том случае, если он непосредственно соответствует сборке, сгенерированной им. Вы можете удалить его в папке bin вашего клиента, но он ничего не сделает. Возможно, вы сможете переименовать файл в соответствии с DLL-файлом, содержащим прокси-сервер WCF клиента. Типы прокси будут находиться в разных пространствах имен, и они не будут напрямую соответствовать типам источников, поэтому никаких гарантий нет. – jrista

+1

Это настоящий позор ... Интересно, есть ли способ продлить процесс, который генерирует Reference.cs, чтобы также потянуть за комментарии. – Kritner

 Смежные вопросы

  • Нет связанных вопросов^_^