Web service XMLSerializer WSDL parameter descriptions

[PMCG]

Hi
Is it possible to decorate web service parameters with attributes that can add documentation elements to the complex type for a web method in WSDL, something similar to what the WebMethodAttrib ute provides for the method itself.
For something lik

[XmlRootAttribut e("p")
public sealed class Poin

[XmlElementAttri bute("x")] public int XCoOrdinate
[XmlElementAttri bute("y")] public int YCoOrdinate
[WebMethodAttrib ute(Description ="Do some work")
public void DoWork(Point input

.....
Is there anyway to include a similar description for the point parameters XCoOrdinate and YCoOridinate members that would just appear in the WSDL but would not obviously appear in the SOAP payload ?
The above example is pretty trivial but illustrates what I'm enquiring about, I would prefer to use attributes rather than going down the root of manually writing the WSDL or going as far as WSE

Thanks in advanc
Pa

[Christoph Schittko [MVP]]

PMCG,

No, there is not. Maybe it's in part because there is no "good place" to put
such descriptions. The point class results in a schema type in the WSDL and
unlike all the WSDL types [0] , arbitrary schema types don't include a
definition for standard documention element. One could argue that a tool
could generate XML schema annotation elements such as

<complexType name="pointType ">
<sequence>
<element name="x" type="integer"> <annotation><do cumentation>Thi s is an X
coordinate. It's perpendicular to the Y
coordinate</documentation></annotation></element>
</sequence>
</complexType>

But that maybe that was deemed to be too verbose.

The best place would be to create a <documentatio n> element inside the
message definitions. Unfortunately, there is nothing that explicitly allows
customization of the generated WSDL <message> element.

If you really wanted that functionality you would have to customize the
ASP.NET WSDL generation to look for custom attributes.
--
HTH
Christoph Schittko [MVP, XmlInsider]
Software Architect, .NET Mentor

[0] http://www.w3.org/TR/wsdl#_documentation

"PMCG" <an*******@disc ussions.microso ft.com> wrote in message
news:30******** *************** ***********@mic rosoft.com...

Hi,
Is it possible to decorate web service parameters with attributes that can add documentation elements to the complex type for a web method in WSDL,
something similar to what the WebMethodAttrib ute provides for the method
itself. For something like

[XmlRootAttribut e("p")]
public sealed class Point
{
[XmlElementAttri bute("x")] public int XCoOrdinate;
[XmlElementAttri bute("y")] public int YCoOrdinate;
}

[WebMethodAttrib ute(Description ="Do some work")]
public void DoWork(Point input)
{
......
}

Is there anyway to include a similar description for the point parameters XCoOrdinate and YCoOridinate members that would just appear in the WSDL but
would not obviously appear in the SOAP payload ? The above example is pretty trivial but illustrates what I'm enquiring about, I would prefer to use attributes rather than going down the root of
manually writing the WSDL or going as far as WSE.
Thanks in advance
Pat