Схема параметров веб-служб

  • Статья

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

Схема параметров веб-служб определяет элементы файла конфигурации, которые управляют поведением веб-служб ASP.NET и их клиентов. Родительский элемент — <webServices>.

По умолчанию элемент <webServices> и его потомки применяются к любым веб-службам или прокси-классам, к которым применяется конфигурация. Конфигурация применяется в соответствии с типом приложения следующим образом:

  • Веб-приложение ASP.NET (служба или клиент): см. раздел Иерархия и наследование файла конфигурации ASP.NET, где описаны стандартные правила наследования конфигурации, области и приоритета для веб-приложений ASP.NET. Элемент <webServices> обычно размещается в файле Web.config.

  • Изолированное приложение на платформе .NET Framework (только клиент): см. раздел Файлы конфигурации приложений. Элемент <webServices> обычно размещается в файле конфигурации приложения.

Элемент <webServices> и его потомки применяются к следующим типам классов.

  • Класс веб-служб, унаследованный от класса WebService.

  • Клиентский прокси-класс, косвенно унаследованный от класса WebClientProtocol.

Элемент <webServices> может применяться как к веб-службе, так и к клиенту, если веб-приложение содержит обе эти сущности.

<configuration>
   <system.web>
      <webServices>
         <protocols>
            <add>
            <remove>
            <clear>
         <serviceDescriptionFormatExtensionTypes>
            <add>
            <remove>
            <clear>
         <soapExtensionTypes>
            <add>
            <remove>
            <clear>
         <soapExtensionImporterTypes>
            <add>
            <remove>
            <clear>
         <soapExtensionReflectorTypes>
            <add>
            <remove>
            <clear>
         <wsdlHelpGenerator>

Элемент Описание

Элемент <add> для элемента <protocols>

Добавляет заданные протоколы, которые могут использоваться веб-службой ASP.NET для получения запросов, передаваемых клиентом, и возврата ответов.

Элемент <add> для элемента <serviceDescriptionFormatExtensionTypes>

Добавляет заданный класс расширения формата описания службы (SDFE), определяющий, как расширять описания служб (документы WSDL), созданные для веб-служб.

Элемент <add> для элемента <soapExtensionTypes>

Добавляет заданный класс расширения SOAP, который обеспечивает расширенную обработку сообщений SOAP в веб-службе или клиенте.

Элемент <add> для элемента <soapExtensionImporterTypes>

Добавляет заданный класс импортера расширения SOAP, который расширяет процесс создания клиентского прокси-класса для использования с расширением формата описания службы (SDFE).

Элемент <add> для элемента <soapExtensionReflectorTypes>

Добавляет заданный класс отражателя расширения SOAP, который расширяет процесс создания описания службы (документа WSDL) для использования с расширением формата описания службы (SDFE).

<clear>

Удаляет все ссылки на элементы, соответствующие родительскому тегу.

<protocols>

Задает протоколы, которые могут использоваться веб-службой ASP.NET для получения данных запросов, передаваемых клиентом, и возврата данных ответов. Протокол можно использовать, чтобы связать данные запроса с методом и его параметрами, а также данные ответа с методом и возвращаемым значением.

Элемент <remove> для элемента <protocols>

Удаляет заданный протокол для обработки данных запросов и ответов из области файла конфигурации.

Элемент <remove> для элемента <serviceDescriptionFormatExtensionTypes>

Удаляет заданный класс расширения формата описания службы (SDFE) из области файла конфигурации.

Элемент <remove> для элемента <soapExtensionTypes>

Удаляет заданный класс расширения SOAP из области файла конфигурации.

Элемент <remove> для элемента <soapExtensionImporterTypes>

Удаляет заданный класс импортера расширения SOAP из области файла конфигурации.

Элемент <remove> для элемента <soapExtensionReflectorTypes>

Удаляет заданный класс отражателя расширения SOAP из области файла конфигурации.

Элемент <serviceDescriptionFormatExtensionTypes>

Задает классы расширения формата описания службы (SDFE), которые используются для расширения документов WSDL, созданных для веб-служб. Классы SDFE обеспечивают средства описания расширений SOAP.

<soapExtensionImporterTypes>

Указывает классы импортера расширения SOAP, расширяющие процесс создания клиентского прокси-класса. Используется с расширениями формата описания службы (SDFE).

<soapExtensionReflectorTypes>

Задает классы отражателей расширений SOAP, которые расширяют процесс создания описания службы (документа WSDL). Используется с расширениями формата описания службы (SDFE).

<soapExtensionTypes>

Задает расширения SOAP, используемые для проверки или изменения сообщения SOAP в процессе его обработки на стороне веб-службы или клиента. Расширения SOAP расширяют функциональность веб-служб.

<webServices>

Управляет параметрами веб-служб, развернутых с помощью ASP.NET, и клиентов веб-служб, работающих на платформе .NET Framework.

<wsdlHelpGenerator>

Задает страницу справки веб-службы (файл ASPX), которая отображается в обозревателе при непосредственном переходе на страницу ASMX веб-службы.

См. также

Другие ресурсы

ASP.NET Settings Schema
XML-веб-службы, созданные с помощью ASP.NET, и клиенты XML-веб-служб