473,698 Members | 2,274 Online
Bytes | Software Development & Data Engineering Community
+ Post

Home Posts Topics Members FAQ

Web service XMLSerializer WSDL parameter descriptions

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

Nov 12 '05 #1
1 4323
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

Nov 12 '05 #2

This thread has been closed and replies have been disabled. Please start a new discussion.

Similar topics

2
10993
by: raymond | last post by:
Hi, Is it possible to create a proxy client class or a web service method by VS.NET without using wsdl? My stupid client is using a xml schema (.xsd) to describe all their web service methods (and my webmethods) by Java (Apache toolkit) instead of using WSDL. What should I do? Thanks a lot! Raymond
0
2494
by: umhlali | last post by:
I get the following exception when my VB.NET app calls a Java web service that returns an array of objects. The same call works for a single object though. So looks like there is no problem serializing the object but there seems to be a problem serializing an array of objects. Any help will be appreciated "Cannot assign object of type System.Object to an object of type ElectronicWallet.C2PTest.PaymentItem." :...
3
5062
by: Jerome Cohen | last post by:
AI am trying to call a third-party web service. this service expects an XML fragment that contains the request plus other parameter. adding the web reference created the syntax below(reference.vb). I changed the data type for the structure that contains the XML data from the default "String" to "xml.xmldocument" to enable easy filling of the data. my client code creates an XML document class, fills the data using standard xml dom...
7
3088
by: Jorgen Haukland, Norway | last post by:
Hi, I have created a Java webservice which runs in IBM WebSphere appserver. I take the WSDL-file and create a VS.NET WinForm application and calls the service running on my PC and everything works fine. So I deploy the webservice on a remote machine (Linux box) and I get an error when calling the service. BUT: I can retrieve the WSDL and make a webreference in my VS.NET project, so obviously I (or more correct: My VS.NET project) am...
4
9654
by: Steven.Dahlin | last post by:
My C# Winform WebService client is attempting to access data from a Web Service written in Java and running on an Oracle App Server 10.3. I have a TCP/IP monitor running and have verified that there is a payload being returned. However, my response object remains a null after the app completes the web service call. Somehow the data which is being returned is being filtered out. I should note that the wsdl provided by the service...
1
4166
by: Vaibhav Modak | last post by:
Hi All, I have a Web Service written in Java (Web Logic) and I am trying to call it in my ASP. NET client. I am facing a problem while getting the data from the Web Service Method. My Web Service returns me an object which is a wrapper around an array of objects. (Earlier I was trying to read the array directly but could not succeed - so I wrapped that array with another object.) Now the primary issue is regarding the chunky characters...
3
11862
by: CJF | last post by:
Is there a way to build a web service from an existing wsdl? I do not wish to create a .Net web service client proxy from a wsdl, but an actual web service. I tried using the wsdl.exe utility, but the output is class of type SoapHttpClientProtocol and not WebService. It was my understanding that you could create both client proxies and web services from an existing wsdl file? If not, what's another way of creating a .NET web service that...
3
6095
by: Jeremy Chapman | last post by:
I've writtin a very simple web service in axis which returns an array of classes. I consume it in a .net app. When receiving the response, my .net app generates an error "Cannot assign object of type System.Object to an object of type PersonWS.WorkGroupData.". I've included the wsdl of the consumed axis web service, the request/responses of the web service by the .net app and the exception and stack trace. Hoping someone can tell me...
0
2799
by: theonlydavewilliams | last post by:
Hi there I'm hoping there's an easy answer to a (hopefully) not too long-winded issue... I'm building a C# web client using a proxy wsdl.exe'd from a wsdl file and six schemas, each in a different namespace. Some schemas extend complex types in others. When i get a soap:Fault from my test server it could contain a serialized exception object (called fault) from one of two of these schemas (and different namespaces, call them xmlns:b0="ns1" and...
0
8672
marktang
by: marktang | last post by:
ONU (Optical Network Unit) is one of the key components for providing high-speed Internet services. Its primary function is to act as an endpoint device located at the user's premises. However, people are often confused as to whether an ONU can Work As a Router. In this blog post, we’ll explore What is ONU, What Is Router, ONU & Router’s main usage, and What is the difference between ONU and Router. Let’s take a closer look ! Part I. Meaning of...
0
8600
by: Hystou | last post by:
Most computers default to English, but sometimes we require a different language, especially when relocating. Forgot to request a specific language before your computer shipped? No problem! You can effortlessly switch the default language on Windows 10 without reinstalling. I'll walk you through it. First, let's disable language synchronization. With a Microsoft account, language settings sync across devices. To prevent any complications,...
1
8892
by: Hystou | last post by:
Overview: Windows 11 and 10 have less user interface control over operating system update behaviour than previous versions of Windows. In Windows 11 and 10, there is no way to turn off the Windows Update option using the Control Panel or Settings app; it automatically checks for updates and installs any it finds, whether you like it or not. For most users, this new feature is actually very convenient. If you want to control the update process,...
0
8860
tracyyun
by: tracyyun | last post by:
Dear forum friends, With the development of smart home technology, a variety of wireless communication protocols have appeared on the market, such as Zigbee, Z-Wave, Wi-Fi, Bluetooth, etc. Each protocol has its own unique characteristics and advantages, but as a user who is planning to build a smart home system, I am a bit confused by the choice of these technologies. I'm particularly interested in Zigbee because I've heard it does some...
1
6518
isladogs
by: isladogs | last post by:
The next Access Europe User Group meeting will be on Wednesday 1 May 2024 starting at 18:00 UK time (6PM UTC+1) and finishing by 19:30 (7.30PM). In this session, we are pleased to welcome a new presenter, Adolph Dupré who will be discussing some powerful techniques for using class modules. He will explain when you may want to use classes instead of User Defined Types (UDT). For example, to manage the data in unbound forms. Adolph will...
0
5860
by: conductexam | last post by:
I have .net C# application in which I am extracting data from word file and save it in database particularly. To store word all data as it is I am converting the whole word file firstly in HTML and then checking html paragraph one by one. At the time of converting from word file to html my equations which are in the word document file was convert into image. Globals.ThisAddIn.Application.ActiveDocument.Select();...
0
4361
by: TSSRALBI | last post by:
Hello I'm a network technician in training and I need your help. I am currently learning how to create and manage the different types of VPNs and I have a question about LAN-to-LAN VPNs. The last exercise I practiced was to create a LAN-to-LAN VPN between two Pfsense firewalls, by using IPSEC protocols. I succeeded, with both firewalls in the same network. But I'm wondering if it's possible to do the same thing, with 2 Pfsense firewalls...
1
3038
by: 6302768590 | last post by:
Hai team i want code for transfer the data from one system to another through IP address by using C# our system has to for every 5mins then we have to update the data what the data is updated we have to send another system
2
2323
muto222
by: muto222 | last post by:
How can i add a mobile payment intergratation into php mysql website.

By using Bytes.com and it's services, you agree to our Privacy Policy and Terms of Use.

To disable or enable advertisements and analytics tracking please visit the manage ads & tracking page.