2011-06-17 22 views
11

मुझे मानक सारांश पृष्ठ पर दिखाने के लिए मेरा सारांश, सर्वो जानकारी, रिटर्न जानकारी इत्यादि (नीचे सूचीबद्ध) चाहिए .net .asmx वेब सेवाओं के लिए उत्पन्न करता है।.asmx वेब सेवा प्रलेखन

/// <summary> 
/// Brief description 
/// </summary> 
/// <param name="fakeParamOne">Fake Param One Description</param> 
/// <returns>Bool representing foo</returns> 

केवल एक चीज है कि मैं कोशिश की है कि किसी भी तरह से स्वत: जनरेट मदद पृष्ठ प्रभावित यह था:

[WebMethod(Description = "Does awesome things.")] 

मुझे यकीन है कि मैं बहुत सरल कुछ याद कर रहा हूँ कर रहा हूँ (या यह है जो भी मैं चाहता हूं उसे करने के लिए संभव नहीं है)। कोई सुझाव?

+0

वहाँ आप क्या कह रहे हैं करने के लिए कोई स्वत: रास्ता नहीं है। वास्तव में, सहायता पृष्ठ डब्ल्यूसीएफ में छोड़ दिया गया है, क्योंकि यह बहुत सीमित उपयोगिता का था। –

+1

"डब्ल्यूसीएफ में सहायता पृष्ठ छोड़ दिया गया है, क्योंकि यह बहुत सीमित उपयोगिता का था"? आपसे क्षमा चाहता हूँ??? आप मेरे साथ मजाक कर रहे हैं! – Jenda

उत्तर

22

@ जॉन सॉंडर्स टिप्पणी की तरह, उल्लेख किया गया है कि डब्लूएसडीएल सहायता में दिखाने के लिए एक्सएमएल विधि टिप्पणियों का उपयोग करने का वास्तव में एक स्वचालित तरीका नहीं है, लेकिन आप जो खोज रहे हैं उसे पाने के लिए कुछ विकल्प हैं।

const string someWebMethodDescription = @" 
<table> 
    <tr> 
     <td>Summary:</td><td>[My Summary]</td> 
    </tr> 
    <tr> 
     <td>Parameters:</td><td>&nbsp;</td> 
    </tr> 
    <tr> 
     <td>fakeParam:</td><td>[My Fake Param Description]</td> 
    </tr> 
</table>"; 

[WebMethod(Description=someWebMethodDescription)] 
public List<string> SomeWebMethod 

कहाँ परिणाम है::

Web Method with Custom HTML Description

वैकल्पिक रूप से, बनाने के लिए

WebMethod विवरण विशेषता एचटीएमएल प्रारूप तैयार किया जाता करने के लिए

यहाँ सेट किया जा सकता एक उदाहरण है एक कस्टम डब्लूएसडीएल सहायता पृष्ठ

<configuration> 
    <system.web> 
     <webServices> 
     <wsdlHelpGenerator href="docs/HelpPage.aspx"/> 
     </webServices> 
    </system.web> 
</configuration> 

जांच अपनी खुद की HelpPage बनाने पर जानकारी के लिए इस codeproject पोस्ट:

Improving the ASP.NET Webservice Help Generator to Reflect Inheritance - CodeProject

संबंधित मुद्दे