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

  • Статья

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

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

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

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

Синтаксис

<add type="fully qualified type name [,Version=version number] [,Culture=culture] [,PublicKeyToken= token]"
   priority="number"
   group="0|1"/>

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

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

Атрибуты

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

type

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

Задает добавляемый класс расширения SOAP. Значение атрибута type должно располагаться на одной строке и содержать полное имя типа. Когда сбора помещается в глобальный кэш сборок (GAC), она должна также содержать версию, язык и региональные параметры и маркер открытого ключа подписанной сборки.

priority

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

Вместе с атрибутом group указывает относительный порядок выполнения расширений SOAP, если для выполнения настроено несколько расширений SOAP. Внутри каждой группы group атрибут priority определяет общий относительный приоритет расширения SOAP. Чем ниже число атрибута priority, тем более высокий приоритет имеет расширение SOAP. Минимальное возможное значение атрибута priority равно 1.

group

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

  • Вместе с атрибутом priority указывает относительный порядок выполнения расширений SOAP, если для выполнения настроено несколько расширений SOAP.

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

Нет.

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

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

configuration

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

soapExtensionTypes

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

system.web

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

webServices

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

Пример

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

<configuration>
   <system.web>
      <webServices>
         <soapExtensionTypes>
            <add type="Contoso.Extensions.MySoapExtension, Version=2.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"  priority="2" group="0"/>
         </soapExtensionTypes>
      </webServices>
   </system.web>
</configuration>

См. также

Справочник

Элемент <webServices>
Элемент <soapExtensionTypes>
SoapExtension

Основные понятия

Изменение сообщений SOAP с помощью расширений SOAP

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

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