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

  • Статья

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

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

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

<configuration>
  <system.web>
    Элемент <webServices>
      Элемент <protocols>
        Элемент <add> для элемента <protocols>

Синтаксис

<add name="protocol name"/>

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

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

Атрибуты

Атрибут Описание

name

Обязательный атрибут.

Имя добавляемого протокола.

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

Нет.

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

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

configuration

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

system.web

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

webServices

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

protocols

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

Замечания

Все четыре возможных протокола используют протокол HTTP/1.1 в качестве транспортного. Выражаясь буквально, значения HttpGet и HttpPost используют методы GET и POST класса HTTP. Значение HttpSoap также использует метод POST, но без традиционной семантики HTTP POST, используемой формой HTML.

Пример

В следующем примере включаются все четыре поддерживаемых протокола.

<configuration>
   <system.web>
      <webServices>
         <protocols>
            <add name="HttpSoap"/>
            <add name="HttpPost"/>
            <add name="HttpGet"/>
            <add name="Documentation"/>
         </protocols>
      </webServices>
   </system.web>
</configuration>

См. также

Справочник

Элемент <webServices>
Элемент <protocols>

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

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