Esquema de configuración de servicios web

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.

El esquema de configuración de servicios Web define elementos de archivos de configuración que controlan el comportamiento de los servicios Web ASP.NET y sus clientes. El elemento principal es <webServices>.

De manera predeterminada, el elemento <webServices> y sus descendientes se aplican a cualquier servicio Web o clase de proxy a la que se aplica la configuración. La configuración se aplica según el tipo de aplicación, tal como se indica a continuación:

• Aplicación web ASP.NET (servicio o cliente): consulte en el apartado sobre Jerarquía de archivos y herencia de la configuración de ASP.NET respecto a las reglas estándar para la herencia de configuración, ámbito y prioridad dentro de una aplicación web ASP.NET. El elemento <webServices> suele colocarse en un archivo Web.config.

• Aplicación .NET Framework independiente (solo cliente): Consulte el apartado sobre Archivos de configuración de la aplicación. El elemento <webServices> suele colocarse en el archivo de configuración de la aplicación.

El elemento <webServices> y sus descendientes se aplican a los siguientes tipos de clases:

• Una clase de servicio Web que se deriva de WebService.

• Una clase de proxy de cliente que se deriva indirectamente de WebClientProtocol.

Un elemento <webServices> puede aplicarse tanto a un servicio Web como a un cliente en el caso de que una aplicación web contenga ambas entidades.

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

Elemento	Descripción
<add> para <protocols>	Agrega un protocolo especificado que puede utilizar un servicio Web ASP.NET para recibir datos de solicitudes enviados por un cliente y devolver datos de respuesta.
<add> para <serviceDescriptionFormatExtensionTypes>	Agrega una clase especificada de extensión de formato de descripción de servicios (SDFE) que define cómo extender las descripciones de servicio (documentos WSDL) generadas para los servicios Web.
<add> para <soapExtensionTypes>	Agrega una clase especificada de extensión SOAP que proporciona procesamiento extendido de mensajes SOAP en el servicio Web o en el cliente.
<add> para <soapExtensionImporterTypes>	Agrega una clase especificada de importador de extensión SOAP, que extiende el proceso de generación de proxy de cliente para el uso con una extensión de formato de descripción de servicio (SDFE).
<add> para <soapExtensionReflectorTypes>	Agrega una clase especificada de reflector de extensión SOAP que extiende el proceso de generación de descripción de servicio (documento WSDL) para el uso con una extensión de formato de descripción de servicio (SDFE).
<clear>	Quita todas las referencias a los elementos correspondientes a la etiqueta primaria.
<protocols>	Especifica los protocolos que puede utilizar un servicio Web ASP.NET para recibir datos de solicitudes enviados por un cliente y devolver datos de respuesta. Un protocolo puede utilizarse para asociar los datos de la solicitud con un método y sus parámetros, así como para asociar los datos de la respuesta con el método y su valor devuelto.
<remove> para <protocols>	Quita un protocolo especificado para controlar datos de solicitud y respuesta del ámbito del archivo de configuración.
<remove> para <serviceDescriptionFormatExtensionTypes>	Quita del ámbito del archivo de configuración una clase especificada de extensión de formato de descripción de servicio (SDFE).
<remove> para <soapExtensionTypes>	Quita una clase de extensión SOAP especificada del ámbito del archivo de configuración.
<remove> para <soapExtensionImporterTypes>	Quita del ámbito del archivo de configuración una clase especificada de importador de extensión SOAP.
<remove> para <soapExtensionReflectorTypes>	Quita del ámbito del archivo de configuración una clase especificada de reflector de extensión SOAP.
<serviceDescriptionFormatExtensionTypes>	Especifica las clases de extensión de formato de descripción de servicio (SDFE) utilizadas para extender los documentos WSDL generados para los servicios Web. Las clases SDFE proporcionan un medio de describir extensiones SOAP.
<soapExtensionImporterTypes>	Especifica clases de importador de extensión SOAP, que extienden el proceso de generación de proxy de cliente. Para el uso con extensiones de formato de descripción de servicios (SDFE).
<soapExtensionReflectorTypes>	Especifica clases de reflector de extensión SOAP que amplían el proceso de generación de descripción de servicio (documento WSDL). Para el uso con extensiones de formato de descripción de servicios (SDFE).
<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.
<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.
<wsdlHelpGenerator>	Especifica la página de Ayuda del servicio Web (un archivo .aspx) que se muestra en el explorador cuando éste navega directamente a una página ASMX de servicios Web.

Vea también

Otros recursos

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