Compartir a través de


<add> (elemento) para <protocols>

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.

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

Jerarquía del esquema

<configuration>
  <system.web>
    <webServices> (elemento)
      <protocols> (elemento)
        <add> (elemento) para <protocols>

Sintaxis

<add name="protocol name"/>

Atributos y elementos

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

Atributos

Atributo Descripción

nombre

Atributo necesario.

Nombre del protocolo que se va a agregar.

Elementos secundarios

Ninguno.

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. Contiene los elementos que configuran las aplicaciones web ASP.NET y determinan su funcionamiento.

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.

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.

Notas

Los cuatro protocolos posibles utilizan el protocolo HTTP/1.1 (Protocolo de transferencia de hipertexto) como medio de transporte. Literalmente, los valores de protocolo HttpGet y HttpPost usan los métodos GET y POST de HTTP. El valor HttpSoap también usa el método POST, pero sin la semántica tradicional de HTTP POST que usa un formulario HTML.

Ejemplo

En el ejemplo siguiente se habilitan los cuatro protocolos admitidos.

<configuration>
   <system.web>
      <webServices>
         <protocols>
            <add name="HttpSoap"/>
            <add name="HttpPost"/>
            <add name="HttpGet"/>
            <add name="Documentation"/>
         </protocols>
      </webServices>
   </system.web>
</configuration>

Vea también

Referencia

<webServices> (elemento)
<protocols> (elemento)

Otros recursos

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