Элемент <webServices>

  • Статья

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

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

Иерархия схемы

<configuration>
  <system.web>
    Элемент <webServices>

Синтаксис

<webServices> 
   <protocols> 
      <add name="protocol name"/>
      <remove name="protocol name"/>
      <clear/>
   </protocols>
   <serviceDescriptionFormatExtensionTypes> 
      <add type="type"/>
      <remove type="type"/>
      <clear/>
   </serviceDescriptionFormatExtensionTypes>
   <soapExtensionTypes>
      <add type="type" priority="number" group="0|1"/>/>
      <remove type="type"/>
      <clear/>
   </soapExtensionTypes>
   <soapExtensionReflectorTypes>
      <add type="type" priority="number" group="0|1"/>/>
      <remove type="type"/>
      <clear/>
   </soapExtensionReflectorTypes>
   <soapExtensionImporterTypes>
      <add type="type" priority="number" group="0|1"/>/>
      <remove type="type"/>
      <clear/>
   </soapExtensionImporterTypes>
   <wsdlHelpGenerator href="help generator file"/>
   <diagnostics suppressReturningExceptions="true|false" />
</webServices>

Атрибуты и элементы

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

Атрибуты

Нет.

Дочерние элементы

Дочерний элемент Описание

diagnostics

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

protocols

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

serviceDescriptionFormatExtensionTypes

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

soapExtensionTypes

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

soapExtensionReflectorTypes

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

soapExtensionImporterTypes

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

wsdlHelpGenerator

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

Родительские элементы

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

configuration

Корневой элемент в любом файле конфигурации, используемом средой CLR и приложениями платформы .NET Framework.

system.web

Задает корневой элемент для раздела конфигурации ASP.NET.

Пример

В следующем примере указаны параметры конфигурации XML-веб-службы.

<configuration>
   <system.web>
      <webServices>
         <diagnostics suppressReturningExceptions="false"/>
         <protocols>
            <add name="HttpGet"/>
            <add name="HttpPost"/>
            <add name="Documentation"/>
         </protocols>
         <serviceDescriptionFormatExtensionTypes>
         </serviceDescriptionFormatExtensionTypes>
         <soapExtensionTypes>
         </soapExtensionTypes>
         <soapExtensionReflectorTypes>
         </soapExtensionReflectorTypes>
         <soapExtensionImporterTypes>
         </soapExtensionImporterTypes>
         <wsdlHelpGenerator href="DefaultSdlHelpGenerator.aspx"/>
      </webServices>
   </system.web>
</configuration>

См. также

Справочник

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

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

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