Export (0) Print
Expand All

Customizing SOAP Message Formatting

This topic is specific to a legacy technology. XML Web services and XML Web service clients should now be created using Windows Communication Foundation .

For ASP.NET Web services that use SOAP to communicate with clients, a sophisticated mechanism is available for controlling the format of the SOAP messages sent in requests and responses. SOAP dictates that the contents of the SOAP messages sent to and from a Web service must be in XML contained in Body and Header elements that in turn are children of an Envelope element (belonging to the namespace http://schemas.xmlsoap.org/soap/envelope/). However, SOAP does not restrict the formatting of the XML.

To produce and consume Web services that use different formatting, the .NET Framework provides an attribute-based mechanism for controlling the format of the XML in the SOAP message. In addition, an attribute-based mechanism for specifying the specific element and attribute names of the SOAP sent over the network is available for controlling the SOAP at a finer level of detail.

Each section in this topic refers to a corresponding How-to topic that shows how to use the attributes discussed.

In This Section

Standard SOAP Message Formats Specified Using WSDL
Describes the standard SOAP message formats that are specified using WSDL.

.NET Framework Support for SOAP Formats
Describes the support that the .NET Framework provides for SOAP formats.

How to: Control the Overall SOAP Body Formatting for a Web Service Method
Describes how to control the overall SOAP body formatting for a Web service method.

How to: Control Parameter and Return Value Formatting for a Web Service Method
Describes how control parameter and return value formatting for a Web service method.

How to: Control Whether Web Service Method Parameters Are Enclosed in an Extra Element
Describes how to control whether Web service method parameters are enclosed in an extra element.

How to: Modify the Default SOAP Formatting for an Entire Web Service
Describes how to modify the default SOAP formatting for an entire Web service.

How to: Customize SOAP Messages with XML Serialization
Describes how to customize SOAP messages with XML serialization.

Reference

System.Xml.Serialization
Contains classes that are used to serialize objects into XML format documents or streams.

SoapRpcMethodAttribute
Specifies that SOAP messages sent to and from the method use RPC formatting.

SoapDocumentServiceAttribute
Applies the optional SoapDocumentServiceAttribute attribute to an XML Web service sets the default format of SOAP requests and responses sent to and from the Web service methods of the Web service.

SoapDocumentMethodAttribute
Applies the SoapDocumentMethodAttribute attribute to a method specifies that SOAP messages to and from the method use Document formatting.

SoapRpcServiceAttribute
Sets the default format of SOAP requests and responses sent to and from Web service methods of a Web service.

Related Sections

Introducing XML Serialization
Provides a general definition of serialization, particularly XML serialization.

SOAP Message Modification Using SOAP Extensions
Explains how to build extensions that modify the SOAP messages sent across the network for XML Web services created using ASP.NET and their clients.

XML Web Services Using ASP.NET
Details how to create XML Web services, using ASP.NET.

Building XML Web Service Clients
Details how to build a client to an XML Web service, regardless of the platform or technology used to build the XML Web service.




Build Date: 2011-02-07
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft