XmlMembersMapping Класс

Определение

Предоставляет сопоставления методов веб-служб .NET Framework и сообщений языка описания веб-служб (WSDL), заданных для веб-служб SOAP.Provides mappings between .NET Framework Web service methods and Web Services Description Language (WSDL) messages that are defined for SOAP Web services.

Этот API поддерживает инфраструктуру продукта и не предназначен для использования непосредственно из программного кода.

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
Наследование
XmlMembersMapping

Комментарии

Класс XmlMembersMapping не используется напрямую.The XmlMembersMapping class is not used directly. Вместо этого используется:Instead, it is used:

  • С помощью средства WSDL. exe или класса ServiceDescriptionImporter, создавая клиентские прокси-классы или абстрактные серверные классы из документа WSDL.By the Wsdl.exe tool, or the ServiceDescriptionImporter class, while generating client proxy classes or abstract server classes from a WSDL document. В документе WSDL указывается использование протокола SOAP.The WSDL document specifies use of the SOAP protocol.

  • Инициализация объектов XmlSerializer во время инициализации .NET Framework веб-службы или клиента SOAP.To initialize XmlSerializer objects while the .NET Framework is initializing a SOAP Web service or client.

  • Классом ServiceDescriptionReflector при создании объектов ServiceDescription из классов, которые определены как веб-службы SOAP.By the ServiceDescriptionReflector class while creating ServiceDescription objects from classes that are identified as SOAP Web services.

Класс XmlMembersMapping заменяет класс XmlTypeMapping для сопоставления методов и сообщений веб-служб.The XmlMembersMapping class is a substitute for the XmlTypeMapping class for mapping between Web service methods and messages. Он используется для хранения любой из следующих сущностей, принадлежащих методу веб-службы SOAP:It is used to contain any of the following entities belonging to a SOAP Web service method:

  • Входные параметры.Input parameters.

  • Выходные параметры и возвращаемое значение.Output parameters and return value.

  • Запрашивать заголовки SOAP.Request SOAP headers.

  • Заголовки ответа SOAP.Response SOAP headers.

В частности, класс представляет сопоставления для определения сообщения WSDL в соответствии со следующими параметрами:Specifically, the class represents mappings for a WSDL message definition, according to the following choices:

  • Для метода веб-службы, использующего кодировку SOAP: свойства верхнего уровня ElementName и TypeName относятся к родительскому элементу, упаковщику. части сообщения представлены членами массива.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. Однако в редких случаях, когда операция веб-службы использует стиль документа в сочетании с упакованной привязкой к .NET Framework методу и кодировке SOAP, свойства ElementName верхнего уровня и TypeName относятся к элементу , который отображается в созданном документе WSDL.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.

  • Для метода веб-службы, который выполняет литеральное использование определений XML-схем: Если сообщение веб-службы или операция использует упакованную привязку к .NET Framework методу или просто определяет одну часть сообщения, свойства ElementName и TypeName верхнего уровня относятся к части.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. Если существует несколько частей (нетипичный случай), свойства ElementName верхнего уровня и TypeName относятся к родительскому элементу-оболочке. части представлены свойствами Count и индексированного доступа к массиву.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. Кроме того, элемент XSD any получает специальную обработку.In addition, the XSD any element receives special treatment.

Свойства

Count

Получает число сущностей кода .NET Framework, принадлежащего методу веб-службы, с которым сопоставляется сообщение SOAP.Gets the number of .NET Framework code entities that belong to a Web service method to which a SOAP message is being mapped.

ElementName

Возвращает неполное имя элемента схемы XML, представляющего сообщение SOAP, для которого предоставляется информация о сопоставлении типа .NET.Gets the unqualified name of the XML Schema element that represents a SOAP message for which .NET type mapping information is being provided.

Item[Int32]

Получает элемент, содержащий информацию внутреннего сопоставления типа для сущности кода .NET Framework, принадлежащей методу веб-службы, который сопоставляется с сообщением SOAP.Gets an item that contains internal type mapping information for a .NET Framework code entity that belongs to a Web service method being mapped to a SOAP message.

Namespace

Получает пространство имен XML элемента схемы XML, представляющего сообщение SOAP, для которого предоставляется информация сопоставления типа платформы .NET Framework.Gets the XML namespace of the XML schema element that represents a SOAP message for which .NET Framework type mapping information is being provided.

TypeName

Получает имя типа платформы .NET Framework, сопоставляемого с типом данных элемента схемы XML, представляющего сообщение SOAP.Gets the name of the .NET Framework type being mapped to the data type of an XML Schema element that represents a SOAP message.

TypeNamespace

Получает пространство имен типа платформы .NET Framework, сопоставляемого с типом данных элемента схемы XML, представляющего сообщение SOAP.Gets the namespace of the .NET Framework type being mapped to the data type of an XML Schema element that represents a SOAP message.

XsdElementName

Возвращает имя XSD-элемента сопоставления.Gets the name of the XSD element of the mapping.

(Унаследовано от XmlMapping)

Методы

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
SetKey(String)

Задает ключ для выполнения поиска в сопоставлении.Sets the key used to look up the mapping.

(Унаследовано от XmlMapping)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Применяется к

Дополнительно