Acceso a servicios Web XML desde un explorador

Después de publicar un servicio Web XML creado mediante ASP.NET, puede llamar a uno de los métodos de servicio Web XML con un explorador para probar su funcionalidad. Para ello, implemente el servicio Web XML en un servidor Web y, después, conecte con el servicio Web XML desde un explorador. Una vez implementado el archivo .asmx en un servidor Web, puede probar el servicio Web XML en un explorador mediante HTTP-GET o HTTP-POST.

**Nota   **De forma predeterminada, un servicio Web XML creado mediante ASP.NET admite varios protocolos, entre los que se incluyen HTTP-GET, HTTP-POST y HTTP-SOAP.

Para probar un servicio Web XML en un explorador mediante HTTP-GET

1. Implemente el servicio Web XML en un servidor Web. Para obtener más información, vea Publicación e implementación de servicios Web XML.

2. Obtenga acceso a un explorador Web y escriba la dirección URL del servicio Web XML en la barra de dirección, con el formato siguiente:

   https://servername/apppath/webservicename.asmx
   

   Parámetro	Valor
   servername	Nombre del servidor en el que se implementó el servicio Web XML.
   Apppath	Nombre del directorio virtual y el resto de la ruta de acceso de la aplicación Web.
   webservicename.asmx	Nombre del archivo .asmx del servicio Web XML.

   Aparecerá el archivo de descripción HTML del servicio Web XML.

3. La página de descripción HTML del servicio Web XML muestra todos los métodos de servicio Web XML admitidos por un servicio determinado. Conecte con el método de servicio Web XML que desee y escriba los parámetros necesarios.

   Por ejemplo, suponga que publica un servicio Web XML denominado StockServices. Este servicio contiene un método de servicio Web XML denominado GetQuote, que requiere un símbolo de cotización como parámetro. Una vez publicado, la dirección URL base del servicio es http://<servername>/apppath/StockServices.asmx. Para probar el servicio, escriba la siguiente solicitud HTTP-GET en la barra de dirección del explorador:

   http://<servername>/apppath/StockServices.asmx
   

   En respuesta a esta solicitud, el servidor mostrará la página de descripción HTML del servicio Web XML. En esta página se enumeran todos los métodos del servicio Web XML. Además, proporciona un medio para probar los métodos y ver las respuestas XML.

   Para especificar más, escriba el método exacto que desea probar. Por ejemplo, puede escribir la línea siguiente para probar el método GetQuote del servicio:

   http://<servername>/apppath/StockServices.asmx/GetStockQuote?tickerName=MSFT
   

   El servidor mostrará una respuesta XML con el precio actual de las acciones que solicita. Si el tipo de datos devuelto para GetQuote es un número de punto flotante de precisión doble, el resultado puede parecerse al siguiente:

   <?xml version="1.0" ?>
   <double>74.5</double>
   

Método alternativo para probar un servicio Web XML en un explorador mediante HTTP-GET

1. Implemente el servicio Web XML en un servidor Web. Para obtener más información, vea Publicación e implementación de servicios Web XML.

2. Obtenga acceso a un explorador Web y escriba la dirección URL del servicio Web XML en la barra de dirección, con el formato siguiente:

   https://servername/vdir/webservicename.asmx/Methodname?parameter=value
   

   Parámetro	Valor
   servername	Nombre del servidor en el que se implementa el servicio Web XML.
   Apppath	Nombre del directorio virtual y el resto de la ruta de acceso de la aplicación Web.
   webservicename.asmx	Nombre del archivo .asmx del servicio Web XML.
   Methodname	Nombre de un método público expuesto por el servicio Web XML. Si se deja en blanco, se mostrará la página de descripción del servicio Web XML, donde se enumeran todos los métodos públicos disponibles en el archivo .asmx. (Opcional)
   parameter	Nombre y valor correspondientes de los parámetros que requiera el método. Si se deja en blanco, se mostrará la página de descripción del servicio Web XML, donde se enumeran todos los métodos públicos disponibles en el archivo .asmx. (Opcional)

   Nota   En el nombre de método de servicio Web XML de esta sintaxis no se distinguen mayúsculas y minúsculas, pero sí se distinguen en los nombres de servidor, proyecto y servicio Web XML.

Por ejemplo, suponga que publica un servicio Web XML denominado StockServices. Este servicio contiene un método de servicio Web XML denominado GetQuote, que acepta un símbolo de cotización como parámetro y devuelve el precio en forma de número de punto flotante de precisión doble. Una vez publicado, la dirección URL base del servicio es http://<servername>/apppath/StockServices.asmx. Para probar el servicio, escriba la siguiente solicitud HTTP-GET en la barra de dirección del explorador:

http://<servername>/apppath/StockServices.asmx/GetStockQuote?tickerName=MSFT

El servidor mostrará una respuesta XML con el precio actual de las acciones que solicita. Si el tipo de datos devuelto para GetQuote es un número de punto flotante de precisión doble, el resultado puede parecerse al siguiente:

<?xml version="1.0" ?>
<double>74.5</double>

Para probar un servicio Web XML en un explorador mediante HTTP-POST

Para probar un servicio Web XML mediante HTTP-POST, debe crear una página HTML con un formulario que tenga el atributo method establecido a POST. A continuación se enumeran los pasos para crear un cliente HTTP-POST para el siguiente servicio Web XML.

<%@ WebService Language="C#" Class="Math" %>
using System.Web.Services;
public class Math : WebService {
     [ WebMethod ]
     public int Add(int num1, int num2) {
          return num1+num2;
     }

     [ WebMethod ]
     public int Subtract(int num1, int num2) {
          return num1-num2;
     }
}
[Visual Basic]
<%@ WebService Language="VB" Class="Math" %>
Imports System.Web.Services

Public Class Math
    Inherits WebService

    <WebMethod> _
    Public Function Add(num1 As Integer, num2 As Integer) As Integer
        Return num1 + num2
    End Function    
    
    <WebMethod> _
    Public Function Subtract(num1 As Integer, num2 As Integer) As Integer
        Return num1 - num2
    End Function
End Class

1. Implemente el servicio Web XML en un servidor Web. Para obtener más información, vea Publicación e implementación de servicios Web XML.

2. Cree un documento HTML con un formulario, mediante el formato siguiente:

      <form method=POST action='https://www.contoso.com/math.asmx/Subtract'>
          <input type="text" size="5" name='num1'\"></td> -
          <input type="text" size="5" name='num2'\"></td> =
          <input type=submit value="Subtract"> </td>
      </form>
   

   Parámetro	Valor
   method	POST. Si desea probar el servicio Web XML mediante HTTP-POST, utilice POST.
   action	Dirección URL del método de servicio Web XML. En el ejemplo anterior, math.asmx es el servicio Web XML y Subtract es el método de servicio Web XML.
   type="text"	Para cada parámetro del método de servicio Web XML, cree etiquetas input con el atributo de tipo establecido a "text". Esto permite escribir un valor de parámetro en el control de entrada de texto.
   name='num1'	Nombre del parámetro de método del servicio Web XML. Agregue al formulario tantos controles de entrada de texto como parámetros contenga el método de servicio Web XML. Por ejemplo, si un método de servicio Web XML tiene tres parámetros, se necesitarán tres controles de entrada de texto con el valor de sus respectivos atributos name establecido al nombre del parámetro.
   type=submit	Agregue un botón para enviar los datos de vuelta al método de servicio Web XML.

3. Obtenga acceso a un explorador Web y escriba la dirección URL del documento HTML que creó en el paso anterior.

   Se mostrará el documento HTML creado en el paso anterior.

4. Especifique los valores correspondientes al método de servicio Web XML en los cuadros de texto y haga clic en el botón submit.

   Por ejemplo, si escribió 6 y, a continuación, 3 en los dos cuadros de texto del método de servicio Web XML Subtract anterior, se devolverá el resultado siguiente:

   <?xml version="1.0" ?> 
   <int xmlns="http://tempuri.org/">3</int>
   

Vea también

Generar clientes de servicios Web XML | Descubrir servicios Web XML | Crear clientes para servicios Web XML | Explorar servicios Web XML existentes creados mediante ASP.NET | Acceso a servicios Web XML desde un explorador