Microsoft.com
Bienvenido Iniciar sesión
Inicio de .NET Framework
Evaluar y enviar comentarios

  Encender vista de ancho de banda bajo
Esta página es específica de
Microsoft Visual Studio 2005/.NET Framework 2.0

Hay además otras versiones disponibles para:
Referencia general de .NET Framework
webServices (Elemento, Esquema de configuración de ASP.NET)

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.

NotaNota

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>

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.

NotaNota

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.

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
Contenido de la comunidad   ¿Qué es Community Content?
Agregar contenido nuevo RSS  Anotaciones
© 2009 Microsoft Corporation. Reservados todos los derechos. Términos de uso  |  Marcas Registradas  |  Privacidad
Page view tracker