Настройка форматирования сообщения SOAP

Этот раздел посвящен технологии прежних версий. Веб-службы XML и клиенты веб-служб XML должны создаваться с использованием Windows Communication Foundation.

Для веб-служб ASP.NET, использующих для взаимодействия с клиентами протокол SOAP, предусмотрен развитый механизм управления форматом сообщений SOAP, отправляемых в запросах и ответах. Протокол SOAP требует, чтобы содержимое сообщений SOAP, отправляемых веб-службе или веб-службой, находилось в коде XML, содержащемся в элементах Body и Header, которые, в свою очередь, являются дочерними элементами элемента Envelope (принадлежащего пространству имен https://schemas.xmlsoap.org/soap/envelope/). Однако протокол SOAP не накладывает ограничений на форматирование XML.

Для создания и использования веб-служб, в которых применяется различное форматирование, в платформе .NET Framework предусмотрен основанный на атрибутах механизм управления форматом кода XML в сообщении SOAP. Кроме того, предусмотрен основанный на атрибутах механизм задания имен конкретных элементов и атрибутов пересылаемых по сети сообщения SOAP для управления протоколом SOAP на более детальном уровне.

В каждом подразделе данного раздела содержится ссылка на практическое руководство, в котором показано, как пользоваться обсуждаемым атрибутом.

В этом разделе

• Стандартные форматы сообщений протокола SOAP, задаваемые с помощью языка WSDL
  Описываются стандартные форматы сообщений протокола SOAP, задаваемые с помощью языка WSDL.

• Поддержка форматов SOAP в платформе .NET Framework
  Описывается поддержка, обеспечиваемая платформой .NET Framework для форматов сообщений SOAP.

• Как управлять общим форматированием текста сообщений SOAP для метода веб-службы
  Описывается, как управлять общим форматированием текста сообщений SOAP для метода веб-службы.

• Как управлять форматированием параметров и возвращаемых значений для метода веб-службы
  Описывается, как управлять форматированием параметров и возвращаемых значений для метода веб-службы.

• Как управлять вложением параметров метода веб-службы в дополнительный элемент
  Описывается, как управлять параметрами метода веб-службы, вложенными в дополнительный элемент.

• Как изменить форматирование сообщений SOAP по умолчанию для всей веб-службы.
  Описывается, как изменять форматирование сообщений SOAP по умолчанию для всей веб-службы.

• Как настроить сообщения SOAP с XML-сериализацией
  Описывается, как настраивать сообщения SOAP с помощью XML-сериализации.

Справочник

• System.Xml.Serialization
  Содержит классы, используемые для сериализации объектов в документы формата XML или в потоки.

• SoapRpcMethodAttribute
  Указывает, что сообщения SOAP, которыми обмениваются с методом, используют форматирование RPC.

• SoapDocumentServiceAttribute
  При применении необязательного атрибута SoapDocumentServiceAttribute к XML-веб-службе устанавливается формат по умолчанию для запросов и ответов SOAP, принимаемых и передаваемых методами веб-службы.

• SoapDocumentMethodAttribute
  Применение атрибута SoapDocumentMethodAttribute к методу указывает на то, что сообщения SOAP, посылаемые в метод и отправляемые из метода, используют форматирование Document.

• SoapRpcServiceAttribute
  Задает формат по умолчанию для запросов и ответов SOAP, передаваемых в метод веб-службы и отправляемых из него.

См. также

• Introducing XML Serialization
  Содержит общее определение сериализации, в особенности, XML-сериализации.

• Изменение сообщений SOAP с помощью расширений SOAP
  Рассматривается создание расширений, изменяющих сообщения SOAP, передаваемые по сети XML-веб-службам, созданным с использованием ASP.NET, и их клиентам.

• XML-веб-службы с использованием ASP.NET
  Рассматривается методика создания XML-веб-служб с помощью ASP.NET.

• Создание клиентов XML-веб-службы
  Подробные сведения о создании клиента XML-веб-службы, независимо от платформы или технологии, использованной для создания XML-веб-службы.

Дата сборки: 2011-02-23