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

[Bob]

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?

[casey chesnut]

i like the idea ... but it cannot be done.
casey

" Bob" <bo*******@yahoo.com> wrote in message
news:OG**************@TK2MSFTNGP09.phx.gbl...

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?

[DalePres]

How about copy and paste?

"casey chesnut" <casey@MORE_spam_PLEASEbrains-N-brawn.com> wrote in message
news:%2****************@TK2MSFTNGP12.phx.gbl...

i like the idea ... but it cannot be done.
casey

" Bob" <bo*******@yahoo.com> wrote in message
news:OG**************@TK2MSFTNGP09.phx.gbl...

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?