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.
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>
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. |
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>
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>
| 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 |
Tareas
Cómo: Configurar directorios concretos mediante la configuración de la ubicación
Cómo: Bloquear los valores de configuración de ASP.NET
Referencia
<webServices> (Elemento)
Esquema de configuración de los servicios Web
Elemento system.web (Esquema de configuración de ASP.NET)
Elemento configuration (Esquema de configuración general)
System.Configuration
System.Web.Configuration
Conceptos
Jerarquía de archivos y herencia de la configuración de ASP.NET
Proteger la configuración de ASP.NET
Escenarios de configuración de ASP.NET
Otros recursos
Opciones de configuración generales (ASP.NET)
Opciones de configuración de ASP.NET
Configurar aplicaciones ASP.NET
Archivos de configuración de ASP.NET
API de configuración de ASP.NET