Provides mappings between .NET Framework Web service methods and Web Services Description Language (WSDL) messages that are defined for SOAP Web services.
See Also: XmlMembersMapping Members
Syntax
Remarks
The System.Xml.Serialization.XmlMembersMapping class is not used directly. Instead, it is used:
By the Wsdl.exe tool, or the System.Web.Services.Description.ServiceDescriptionImporter class, while generating client proxy classes or abstract server classes from a WSDL document. The WSDL document specifies use of the SOAP protocol.
To initialize System.Xml.Serialization.XmlSerializer objects while the .NET Framework is initializing a SOAP Web service or client.
By the System.Web.Services.Description.ServiceDescriptionReflector class while creating System.Web.Services.Description.ServiceDescription objects from classes that are identified as SOAP Web services.
The System.Xml.Serialization.XmlMembersMapping class is a substitute for the System.Xml.Serialization.XmlTypeMapping class for mapping between Web service methods and messages. It is used to contain any of the following entities belonging to a SOAP Web service method:
Input parameters.
Output parameters and return value.
Request SOAP headers.
Response SOAP headers.
Specifically, the class represents mappings for a WSDL message definition, according to the following choices:
For a Web service method that uses SOAP encoding: The top-level XmlMapping.ElementName and XmlTypeMapping.TypeName properties pertain to a parent, wrapper element; the message parts are represented by array members. However, in the rare case when the Web service operation uses document style combined with a wrapped binding to a .NET Framework method plus SOAP encoding, the top-level XmlMapping.ElementName and XmlTypeMapping.TypeName properties pertain to the single part element that appears in a generated WSDL document.
For a Web service method that makes literal use of XML Schema definitions: If a Web service message or operation uses a wrapped binding to a .NET Framework method or merely defines a single message part, the top-level XmlMapping.ElementName and XmlTypeMapping.TypeName properties pertain to the part. If there are multiple parts (the atypical case), the top-level XmlMapping.ElementName and XmlTypeMapping.TypeName properties pertain to a parent, wrapper element; the parts are represented by the XmlMembersMapping.Count and indexed array access properties. In addition, the XSD any element receives special treatment.
Requirements
Assembly: System.Xml (in System.Xml.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0, 4.0.0.0