webServices (Elemento, Esquema de configuración de ASP.NET)

Referencia general de .NET Framework

Controla el comportamiento de los servicios Web de ASP.NET y sus clientes. De forma predeterminada, el elemento webServices y sus descendientes se aplican a cualquier servicio Web o clase de proxy en que la configuración tenga efecto.

Nota
Este elemento está totalmente documentado en Esquema de configuración de los servicios Web, en la sección de configuración principal de .NET Framework SDK. Para obtener más información, vea esa sección.

Elemento <configuration>
Elemento system.web (Esquema de configuración de ASP.NET)
<webServices> (Elemento)

<webServices>
    <conformanceWarnings>...</conformanceWarnings>

    <protocols>...</protocols>

    <soapEnvelopeProcessing.../>

    <serviceDescriptionFormatExtensionTypes>...
    </serviceDescriptionFormatExtensionTypes>

    <soapExtensionImporterTypes>...</soapExtensionImporterTypes>

    <soapExtensionReflectorTypes>...</soapExtensionReflectorTypes>

    <soapExtensionTypes>...</soapExtensionTypes>

    <soapServerProtocolFactoryType.../>
    <soapTransportImporterTypes>...</soapTransportImporterTypes>

    <wsdlHelpGenerator.../>
</webServices>

Atributos y elementos

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

Atributos

Ninguno.

Elementos secundarios

Elemento

Descripción

conformanceWarnings

Elemento opcional.

Define una colección de perfiles de WS-I que se utilizará para validar los servicios Web.

Nota
Actualmente, el único perfil WS-I admitido en .NET Framework es Basic Profile versión 1.1 (BasicProfile 1_1).

protocols

Elemento opcional.

Especifica los protocolos de transmisión que ASP.NET puede utilizar para descifrar los datos enviados desde un explorador del cliente en la solicitud HTTP. Los datos enviados en una solicitud HTTP a un servicio Web XML pueden contener llamadas a métodos y parámetros.

serviceDescriptionFormatExtensionTypes

Elemento opcional.

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

soapExtensionImporterTypes

Elemento opcional.

Especifica las extensiones SOAP que deben ejecutarse cuando se produzca el acceso a una descripción de un servicio Web XML en el ámbito del archivo de configuración para crear una clase de proxy.

soapExtensionReflectorTypes

Elemento opcional.

Especifica las extensiones SOAP que deben ejecutarse cuando se genere una descripción de servicio para todos los servicios Web XML del ámbito del archivo de configuración.

soapExtensionTypes

Elemento opcional.

Especifica las extensiones SOAP que deben ejecutarse con todos los servicios Web XML dentro del ámbito del archivo de configuración.

soapServerProtocolFactoryType

Elemento opcional.

Establece un objeto System.Web.Services.Configuration.TypeElement que corresponde al protocolo utilizado para llamar al servicio Web.

soapTransportImporterTypes

Elemento opcional.

Establece un objeto System.Web.Services.Configuration.TypeElementCollection que representa el elemento System.Web.Services.Configuration.SoapExtensionTypeElement,

wsdlHelpGenerator

Elemento opcional.

Página de Ayuda del servicio Web XML (un archivo .aspx) que se muestra en el explorador cuando éste va directamente a una página .asmx.

Elementos primarios

Elemento	Descripción
configuration	Es el elemento raíz necesario en cada archivo de configuración que utilizan las aplicaciones Common Language Runtime y .NET Framework.
system.web	Especifica el elemento raíz de las opciones de configuración de ASP.NET en un archivo de configuración. Contiene los elementos de configuración que configuran las aplicaciones Web ASP.NET y determinan su funcionamiento.

Comentarios

Este elemento está totalmente documentado en Esquema de configuración de los servicios Web. Para obtener más información, vea esa sección.

Configuración predeterminada

En la versión 1.1 de .NET Framework, el elemento webServices predeterminado siguiente se configura en el archivo de configuración del equipo.

<webServices>
  <protocols>
    <add name="HttpSoap1.2"/>
    <add name="HttpSoap"/>
    <add name="HttpPostLocalhost"/>
    <add name="Documentation"/>
  </protocols>
  <soapExtensionTypes>
  </soapExtensionTypes>
  <soapExtensionReflectorTypes>
  </soapExtensionReflectorTypes>
  <soapExtensionImporterTypes>
  </soapExtensionImporterTypes>
  <wsdlHelpGenerator href="DefaultWsdlHelpGenerator.aspx"/>
  <serviceDescriptionFormatExtensionTypes>
  </serviceDescriptionFormatExtensionTypes>
</webServices>

En la versión 1.0 de .NET Framework, el elemento webServices predeterminado siguiente se configura en el archivo de configuración del equipo.

<webServices>
  <protocols>
    <add name="HttpSoap"/> 
    <add name="HttpPost"/> 
    <add name="HttpGet"/> 
    <add name="Documentation"/> 
  </protocols>
  <soapExtensionTypes>
  </soapExtensionTypes>
  <soapExtensionReflectorTypes>
  </soapExtensionReflectorTypes>
  <soapExtensionImporterTypes>
  </soapExtensionImporterTypes>
  <wsdlHelpGenerator href="DefaultWsdlHelpGenerator.aspx" />
  <serviceDescriptionFormatExtensionTypes>
  </serviceDescriptionFormatExtensionTypes>
</webServices>

El siguiente elemento webServices predeterminado no se configura explícitamente en el archivo de configuración del equipo ni en el archivo Web.config raíz; es la configuración predeterminada que devuelve una aplicación en la versión 2.0 de .NET Framework.

<webServices>
  <conformanceWarnings>
    <add name = "None" />
  </conformanceWarnings>

  <protocols>
    <add name = "Unknown" />
  </protocols>

  <soapEnvelopeProcessing readTimeout = "" />
  <serviceDescriptionFormatExtensionTypes>
    <add type = "" />
  </serviceDescriptionFormatExtensionTypes>

  <soapExtensionImporterTypes>
    <add type = "" />
  </soapExtensionImporterTypes>

  <soapExtensionReflectorTypes>
    <add type = "" />
  </soapExtensionReflectorTypes>

  <soapExtensionTypes>
    <add group = "Low" 
      priority = "0" 
      type = "" />
  </soapExtensionTypes>

  <soapServerProtocolFactoryType type = "" />

  <soapTransportImporterTypes>
    <add type = "" />
  </soapTransportImporterTypes>

  <wsdlHelpGenerator href = "DefaultWsdlHelpGenerator.aspx" />
</webServices>

<webServices>
  <conformanceWarnings>
    <clear />
    <add name="BasicProfile1_1" />
  </conformanceWarnings>
  <protocols>
    <clear />
    <add name="HttpSoap12" />
    <add name="HttpSoap" />
    <add name="HttpPostLocalhost" />
    <add name="Documentation" />
  </protocols>
  <serviceDescriptionFormatExtensionTypes>
    <clear />
  </serviceDescriptionFormatExtensionTypes>
  <soapEnvelopeProcessing readTimeout="2147483647" />
  <soapExtensionImporterTypes>
    <clear />
  </soapExtensionImporterTypes>
  <soapExtensionReflectorTypes>
    <clear />
  </soapExtensionReflectorTypes>
  <soapExtensionTypes>
    <clear />
  </soapExtensionTypes>
  <soapTransportImporterTypes>
    <clear />
  </soapTransportImporterTypes>
  <wsdlHelpGenerator href="DefaultWsdlHelpGenerator.aspx" />
  <soapServerProtocolFactory type="System.Web.Services.Protocols.SoapServerProtocolFactory, System.Web.Services, 
    Version=2.0.0.0, Culture=neutral PublicKeyToken=b03f5f7f11d50a3a" />
</webServices>

Ejemplo

El siguiente ejemplo desactiva las advertencias de conformidad de Basic Profile 1.1 para un sitio Web de ASP.NET.

<configuration>
 <system.web>
    <webServices>
      <conformanceWarnings>
        <remove name='BasicProfile1_1'/>
      </conformanceWarnings>
    </webServices>
  </system.web>
</configuration>

Información de elemento

Controlador de la sección de configuración	WebServicesSection
Miembro de la configuración	webServices
Ubicaciones configurables	Machine.config Web.config del nivel raíz Web.config del nivel de aplicaciones Web.config del nivel de directorio virtual o físico
Requisitos	IIS 5.0, IIS 5.1 o IIS 6.0 .NET Framework 1.0, 1.1 o 2.0 Visual Studio 2003 o Visual Studio 2005

Vea también

Atributos

Elementos secundarios

Elementos primarios

Tareas

Referencia

Conceptos

Otros recursos