Compartir a través de

<webServices> (elemento)

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

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.

Jerarquía del esquema

<configuration>
  <system.web>
    <webServices> (elemento)

Sintaxis

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

Atributos y elementos

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

Atributos

Ninguno.

Elementos secundarios

Elemento secundario Descripción

diagnostics

Especifica si se devuelven excepciones al cliente con fines de depuración.

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.

serviceDescriptionFormatExtensionTypes

Especifica la extensión de formato de descripción de servicio que se ejecuta en el ámbito del archivo de configuración.

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.

soapExtensionReflectorTypes

Especifica clases de reflector de extensión SOAP que amplían el proceso de generación de descripción del servicio (documento WSDL). Para el uso con extensiones de formato de descripción de servicios (SDFE).

soapExtensionImporterTypes

Especifica clases de importador de extensión SOAP, que extienden el proceso de generación de servidor proxy cliente. Para el uso con extensiones de formato de descripción de servicios (SDFE).

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.

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.

system.web

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

Ejemplo

En el ejemplo siguiente se especifican las opciones de configuración del servicio Web 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>

Vea también

Referencia

Esquema de configuración de servicios web

Otros recursos

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