XmlMembersMapping Class

Definition

Provides mappings between .NET Web service methods and Web Services Description Language (WSDL) messages that are defined for SOAP Web services.

This API supports the product infrastructure and is not intended to be used directly from your code.

public ref class XmlMembersMapping : System::Xml::Serialization::XmlMapping
public class XmlMembersMapping : System.Xml.Serialization.XmlMapping
type XmlMembersMapping = class
    inherit XmlMapping
Public Class XmlMembersMapping
Inherits XmlMapping
Inheritance
XmlMembersMapping

Remarks

The XmlMembersMapping class is not used directly. Instead, it is used:

  • By the Wsdl.exe tool, or the 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 XmlSerializer objects while the .NET Framework is initializing a SOAP Web service or client.

  • By the ServiceDescriptionReflector class while creating ServiceDescription objects from classes that are identified as SOAP Web services.

The XmlMembersMapping class is a substitute for the 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 ElementName and 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 ElementName and 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 ElementName and TypeName properties pertain to the part. If there are multiple parts (the atypical case), the top-level ElementName and TypeName properties pertain to a parent, wrapper element; the parts are represented by the Count and indexed array access properties. In addition, the XSD any element receives special treatment.

Properties

Count

This API supports the product infrastructure and is not intended to be used directly from your code.

Gets the number of .NET code entities that belong to a Web service method to which a SOAP message is being mapped.

ElementName

This API supports the product infrastructure and is not intended to be used directly from your code.

Gets the unqualified name of the XML Schema element that represents a SOAP message for which .NET type mapping information is being provided.

ElementName

This API supports the product infrastructure and is not intended to be used directly from your code.

Gets the name of the mapped element.

(Inherited from XmlMapping)
Item[Int32]

This API supports the product infrastructure and is not intended to be used directly from your code.

Gets an item that contains internal type mapping information for a .NET code entity that belongs to a Web service method being mapped to a SOAP message.

Namespace

This API supports the product infrastructure and is not intended to be used directly from your code.

Gets the XML namespace of the XML schema element that represents a SOAP message for which .NET Framework type mapping information is being provided.

Namespace

This API supports the product infrastructure and is not intended to be used directly from your code.

Gets the namespace of the mapped element.

(Inherited from XmlMapping)
TypeName

This API supports the product infrastructure and is not intended to be used directly from your code.

Gets the name of the .NET type being mapped to the data type of an XML Schema element that represents a SOAP message.

TypeNamespace

This API supports the product infrastructure and is not intended to be used directly from your code.

Gets the namespace of the .NET type being mapped to the data type of an XML Schema element that represents a SOAP message.

XsdElementName

This API supports the product infrastructure and is not intended to be used directly from your code.

Gets the name of the XSD element of the mapping.

(Inherited from XmlMapping)

Methods

Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
SetKey(String)

This API supports the product infrastructure and is not intended to be used directly from your code.

Sets the key used to look up the mapping.

(Inherited from XmlMapping)
ToString()

Returns a string that represents the current object.

(Inherited from Object)

Applies to

See also