Velocity Reviews - Computer Hardware Reviews

Velocity Reviews > Newsgroups > Programming > ASP .Net > ASP .Net Web Services > how to get the comments on WS methods to show up in proxy class?

Reply
Thread Tools

how to get the comments on WS methods to show up in proxy class?

 
 
Bob
Guest
Posts: n/a
 
      07-01-2004
I don't know if this is doable but sure very helpful. Is there a way to
make the XML comments or the Description attribute on the [WebMethod] on
the WS to show up in the proxy class generated by VS.NET. E.g.

/// <summary>My test web service.</summary>
/// <param name="someValue">blah blah</param>
/// <returns></returns>
[WebMethod(Description="My test web service to say hello")]
public string Hello(string someValue) {
......................
}

Here's the sync proxy method generated:

/// <remarks/>
[System.Web.Services.Protocols.SoapDocumentMethodAt tribute("http://abcd.com/
Hello", RequestNamespace="http://abcd.com",
ResponseNamespace="http://abcd.com",
Use=System.Web.Services.Description.SoapBindingUse .Literal,
ParameterStyle=System.Web.Services.Protocols.SoapP arameterStyle.Wrapped)]
public string Hello() {
object[] results = this.Invoke("Hello", new object[0]);
return ((string)(results[0]));
}

I can manually add to the <remarks> tag, but if you update the web reference
in VS.NET, it deletes whatever you edited. It's the proxy side that the
client really needs to know how to call so the comments/description is
necessary. Can it be done?


 
Reply With Quote
 
 
 
 
casey chesnut
Guest
Posts: n/a
 
      07-01-2004
i like the idea ... but it cannot be done.
casey

" Bob" <> wrote in message
news:...
> I don't know if this is doable but sure very helpful. Is there a way to
> make the XML comments or the Description attribute on the [WebMethod] on
> the WS to show up in the proxy class generated by VS.NET. E.g.
>
> /// <summary>My test web service.</summary>
> /// <param name="someValue">blah blah</param>
> /// <returns></returns>
> [WebMethod(Description="My test web service to say hello")]
> public string Hello(string someValue) {
> ......................
> }
>
> Here's the sync proxy method generated:
>
> /// <remarks/>
>

[System.Web.Services.Protocols.SoapDocumentMethodAt tribute("http://abcd.com/
> Hello", RequestNamespace="http://abcd.com",
> ResponseNamespace="http://abcd.com",
> Use=System.Web.Services.Description.SoapBindingUse .Literal,
> ParameterStyle=System.Web.Services.Protocols.SoapP arameterStyle.Wrapped)]
> public string Hello() {
> object[] results = this.Invoke("Hello", new object[0]);
> return ((string)(results[0]));
> }
>
> I can manually add to the <remarks> tag, but if you update the web

reference
> in VS.NET, it deletes whatever you edited. It's the proxy side that the
> client really needs to know how to call so the comments/description is
> necessary. Can it be done?
>
>



 
Reply With Quote
 
 
 
 
DalePres
Guest
Posts: n/a
 
      07-02-2004
How about copy and paste?

"casey chesnut" <casey@MORE_spam_PLEASEbrains-N-brawn.com> wrote in message
news:%...
> i like the idea ... but it cannot be done.
> casey
>
> " Bob" <> wrote in message
> news:...
> > I don't know if this is doable but sure very helpful. Is there a way to
> > make the XML comments or the Description attribute on the [WebMethod]

on
> > the WS to show up in the proxy class generated by VS.NET. E.g.
> >
> > /// <summary>My test web service.</summary>
> > /// <param name="someValue">blah blah</param>
> > /// <returns></returns>
> > [WebMethod(Description="My test web service to say hello")]
> > public string Hello(string someValue) {
> > ......................
> > }
> >
> > Here's the sync proxy method generated:
> >
> > /// <remarks/>
> >

>

[System.Web.Services.Protocols.SoapDocumentMethodAt tribute("http://abcd.com/
> > Hello", RequestNamespace="http://abcd.com",
> > ResponseNamespace="http://abcd.com",
> > Use=System.Web.Services.Description.SoapBindingUse .Literal,
> >

ParameterStyle=System.Web.Services.Protocols.SoapP arameterStyle.Wrapped)]
> > public string Hello() {
> > object[] results = this.Invoke("Hello", new object[0]);
> > return ((string)(results[0]));
> > }
> >
> > I can manually add to the <remarks> tag, but if you update the web

> reference
> > in VS.NET, it deletes whatever you edited. It's the proxy side that the
> > client really needs to know how to call so the comments/description is
> > necessary. Can it be done?
> >
> >

>
>



 
Reply With Quote
 
 
 
Reply

Thread Tools

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off
Trackbacks are On
Pingbacks are On
Refbacks are Off


Similar Threads
Thread Thread Starter Forum Replies Last Post
Re: How include a large array? Edward A. Falk C Programming 1 04-04-2013 08:07 PM
Is there a way to find the class methods of a class, just like'methods' finds the instance methods? Kenneth McDonald Ruby 5 09-26-2008 03:09 PM
A program to replace all JS comments with JSP comments in jsp files tungchau81@yahoo.com Javascript 4 06-03-2006 02:00 PM
A program to replace all JS comments with JSP comments in jsp files tungchau81@yahoo.com Java 0 06-02-2006 06:35 AM
Comments format: comments extending over multi-line Monk C Programming 10 04-20-2005 05:09 PM



Advertisments
 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57