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

Этот раздел посвящен технологии прежних версий. Веб-службы 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-веб-служб