Compartir a través de

<add> (elemento) para <protocols>

  • Artículo

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 usarse para asociar los datos de la solicitud con un método y sus parámetros, y para asociar los datos de la respuesta con el método y su valor devuelto.

<configuration>

  <system.web>

    <webServices> (elemento)

      <protocols> (elemento)

        <add> (elemento) para <protocols>

<add name="protocol name"/>

Atributos y elementos

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

Atributos

Atributo Descripción

name

Atributo necesario.

Nombre del protocolo que se va a agregar.

Atributo name

Valor Descripción

HttpGet

  • Agrega el protocolo HTTP GET. Los parámetros de método se pasan en la cadena de consulta que se anexa a la dirección URL de la solicitud HTTP, con el formato ?name1=value1&name2=value2…. El valor devuelto se coloca en el cuerpo de la respuesta HTTP como un documento XML simple (sin <soap:Envelope>).

HttpPost

Agrega el protocolo HTTP POST. Los parámetros de método se pasan en el cuerpo de la solicitud HTTP, con el formato name1=value1&name2=value…. El valor devuelto se coloca en el cuerpo de la respuesta HTTP como un documento XML simple (sin <soap:Envelope>).

HttpSoap

Agrega el protocolo HTTP SOAP. Se envía a un mensaje SOAP en el cuerpo de la solicitud HTTP; la respuesta SOAP se envía en el cuerpo de la respuesta HTTP.

Documentation

Agrega el protocolo especial Documentation. Cuando se habilita este protocolo y se solicita directamente la página .asmx, ASP.NET ejecuta una página auxiliar para crear una página HTML de documentación que se transmite al cliente que realizó la solicitud.

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 usar un servicio Web ASP.NET para recibir datos de solicitudes enviados por un cliente y devolver datos de respuesta. Un protocolo se puede usar para asociar los datos de la solicitud con un método y sus parámetros, y para asociar los datos de la respuesta con el método y su valor devuelto.

Comentarios

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>

Consulte 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

Copyright © 2007 Microsoft Corporation. Reservados todos los derechos.