Compartir a través de

<add> (elemento) para <soapExtensionTypes>

  • Artículo

Este tema es específico de una tecnología heredada. Ahora, los servicios Web XML y los clientes de servicios Web XML deben crearse con Windows Communication Foundation.

Agrega una clase especificada de extensión SOAP que proporciona procesamiento extendido de mensajes SOAP en el servicio Web o en el cliente.

Jerarquía del esquema

<configuration>
  <system.web>
    <webServices> (elemento)
      <soapExtensionTypes> (Elemento)
        <add> (elemento) para <soapExtensionTypes>

Sintaxis

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

Atributos y elementos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo Descripción

type

Atributo necesario.

Especifica la clase de extensión SOAP que se agrega. El valor de atributo de type debe estar en una línea e incluye el nombre de tipo completo. Cuando el ensamblado se encuentra en la caché global de ensamblados (GAC), también debe incluir la versión, la referencia cultural y el token de clave pública del ensamblado firmado.

priority

Atributo necesario.

Junto con group, especifica el orden relativo con el que se ejecutan las extensiones SOAP cuando se configura la ejecución de varias. Dentro de cada group, el atributo priority distingue la prioridad relativa general de la extensión SOAP. Cuanto menor sea el valor de priority , mayor será la prioridad de la extensión SOAP. El valor mínimo posible del atributo priority es 1.

group

Atributo necesario.

  • Junto con priority, especifica el orden relativo con el que se ejecutan las extensiones SOAP cuando se configura la ejecución de varias.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento Descripción

configuration

Elemento raíz de cada archivo de configuración que utilizan las aplicaciones Common Language Runtime y .NET Framework.

soapExtensionTypes

Especifica las extensiones SOAP que se utilizan para inspeccionar o modificar el mensaje SOAP durante el procesamiento en el servicio Web o en el cliente. Las extensiones SOAP aumentan la funcionalidad de los servicios Web.

system.web

Especifica el elemento raíz de la sección de configuración de ASP.NET.

webServices

Controla la configuración de servicios Web implementados mediante ASP.NET y la de los clientes de servicios Web que se ejecutan en .NET Framework.

Ejemplo

En el ejemplo siguiente se agrega una clase de extensión SOAP. Debe tenerse en cuenta que el valor de tipo debe estar en una línea.

<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>

Vea también

Referencia

<webServices> (elemento)
<soapExtensionTypes> (Elemento)
SoapExtension

Conceptos

Modificación de mensajes SOAP con extensiones SOAP

Otros recursos

ASP.NET Settings Schema
Servicios Web XML creados con ASP.NET y clientes de servicio Web XML