ISoapReader (Windows CE 5.0)
This interface, implemented by the SoapReader object, reads SOAP messages. The methods in this interface read the SOAP message and parse the message into a DOM. You can then retrieve the individual elements from the DOM.
The Calc sample application uses the ISoapReader interface. For more information, see SOAP Samples.
Various SoapReader properties make it easy to extract information out of the SOAP message without having to know the message's structure.
Note While you can also retrieve information from a SOAP message using the Microsoft® XML Parser (MSXML) DOM API, the SoapReader properties make it easier to do the same thing.
The following tables show the methods and properties supported by ISoapReader interface.
| Method | Description |
|---|---|
| load | This method loads an XML document from a file, stream, or a URL. |
| loadXML | This method loads an XML document string provided as input. |
| Property | Description |
|---|---|
| Body | This property returns the <Body> element of a SOAP message. |
| BodyEntries | This property returns a collection of entries in the <Body> element of a SOAP message. |
| BodyEntry | This property returns the first entry in the <Body> element of a SOAP message that matches the given local name and namespace URI. |
| DOM | This property provides a reference to the DOM document. |
| Envelope | This property returns the <Envelope> element in a SOAP message (thus, the entire SOAP message). |
| Fault | This property returns the <Fault> element in a SOAP message. |
| faultactor | This property returns the <faultactor> element of the <Fault> element in the SOAP message. |
| faultcode | This property returns the <faultcode> element of the <Fault> element in the SOAP message. |
| FaultDetail | This property returns the <detail> element of the <Fault> element in the SOAP message. |
| faultstring | This property returns the <faultstring> element of the <Fault> element in the SOAP message. |
| Header | This property returns the <Header> element in a SOAP message. |
| HeaderEntries | This property returns a collection of entries in the <Header> element of a SOAP message. |
| HeaderEntry | This property returns the first entry in the <Header> element of a SOAP message that matches the given local name and namespace URI. |
| MustUnderstandHeaderEntries | This property returns all entries from the <Header> element in a SOAP message that have a mustUnderstand attribute equal to 1. |
| RPCParameter | This property returns the first child element of the first entry within the <Body> element of a SOAP that matches the given local name and namespace URI. |
| RPCResult | This property returns the first child element of the first entry in the <Body> element of a SOAP message. |
| RPCStruct | This property returns the first entry in the <Body> element of a SOAP message. |
| soapAction | This property returns the "SOAPAction" HTTP header, if the input was a request object. |
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Mssoap.h.
Link Library: Uuid.lib.
See Also
Send Feedback on this topic to the authors