Cómo: Tener acceso a servicios web XML desde un explorador

Artículo
10/07/2008

Después de publicar un servicio web creado con ASP.NET, puede probar su funcionalidad utilizando un explorador para llamarlo o a través de HTTP-GET o de HTTP-POST. Abra su archivo .asmx en un explorador y, a continuación, haga clic en los hipervínculos a los métodos de servicio web o obtenga acceso directo a los métodos individuales anexando una cadena de consulta a la dirección URL de .asmx.

Nota:
De forma predeterminada, un servicio web creado utilizando ASP.NET puede admitir varios protocolos, incluso SOAP sobre Http e implementaciones de HTTP-GET y HTTP-POST donde en la respuesta no se devuelve ningún SOAP XML.

Para probar un servicio web en un explorador utilizando HTTP-GET

Implementar su servicio web en un servidor web. Para obtener más información, vea Publicación e Implementación del servicio web de XML.

Tenga acceso a un explorador web y escriba la dirección URL para su servicio web en la barra de direcciones, utilizando el formato siguiente:

https://servername/apppath/webservicename.asmx

Parte de la ruta de acceso	Valor
servername	El nombre del servidor en el que se implementó su servicio web.
Apppath	El nombre de su directorio virtual y el resto de la ruta de acceso de la aplicación web.
webservicename.asmx	El nombre del archivo .asmx del servicio web.

Por ejemplo, suponga que ha publicado un servicio web denominado StockServices. Cuando se publica, la dirección URL base para este servicio es http://<servername>/apppath/StockServices.asmx. Podría probar este servicio escribiendo esta solicitud HTTP-GET en la barra de direcciones del explorador:

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

El servidor, en respuesta a esta solicitud, muestra la página de descripción de HTML del servicio web.

La página de descripción HTML del servicio web le muestra todos los métodos de servicio web admitidos por un servicio web determinado. Vincúlelo al método de servicio web deseado y escriba los parámetros necesarios para probar el método y ver la respuesta de XML.

Para probar directamente un método de servicio web en un explorador utilizando HTTP-GET

Implementar su servicio web en un servidor web. Para obtener más información, vea Publicación e Implementación del servicio web de XML.

Abra un explorador web y escriba la dirección URL de su método de servicio web en la barra de direcciones utilizando el siguiente formato:

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

Parámetro	Valor
servername	El nombre del servidor en el que se implementa su servicio web.
Apppath	El nombre de su directorio virtual y el resto de la ruta de acceso de la aplicación web.
webservicename.asmx	El nombre del archivo .asmx del servicio web.
Methodname	El nombre de un método público que es expuesto por su servicio web. Si se deja en blanco, se muestra la página de descripción del servicio web, haciendo una lista de cada método público disponible en el archivo .asmx. (Opcional)
parámetro	El nombre de parámetro adecuado y el valor para cualquier parámetro requerido por su método. Si se deja en blanco, se muestra la página de descripción del servicio web, haciendo una lista de cada método público disponible en el archivo .asmx. (Opcional)

Nota:
El nombre del método de servicio web en esta sintaxis distingue entre mayúsculas y minúsculas, pero el servidor, proyecto y nombres del servicio web no hacen esta distinción.

Por ejemplo, suponga que el servicio web StockServices del procedimiento anterior contiene un método de servicio web llamado GetQuote; el método de servicio web acepta un símbolo de valores bursátiles como un parámetro, devolviendo el precio como un número de punto flotante de precisión doble. Escribir la solicitud HTTP-GET siguiente en la barra de direcciones del explorador para probar este método:

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

El servidor envía una respuesta que contiene un documento XML, que se muestra en el explorador. Para obtener el ejemplo GetQuote, el XML tiene el precio actual de las acciones que solicita. El resultado tendría el siguiente aspecto:

<?xml version="1.0" ?>

<double>74.5</double>

Para probar un servicio web en un explorador utilizando HTTP-POST

Implementar su servicio web en un servidor web. Para obtener más información, vea Publicación e Implementación del servicio web de XML. Este procedimiento utiliza como un ejemplo el servicio web siguiente, implementado como un archivo math.asmx que es accesible desde la raíz virtual del sitio https://www.contoso.com:

<%@ 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;
     }
}

<%@ 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

Cree una página HTML con un formulario que tiene su atributo método establecido para post. Utilice 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
método	POST. Si desea probar su servicio web mediante HTTP-POST, utilice POST.
acción	Dirección URL para el método de servicios web. En el ejemplo anterior, math.asmx es el servicio web y `Subtract` es el método de servicio web.
type="text"	Para cada parámetro del método de servicio web, cree las etiquetas entrada con el atributo de tipo establecido en "text". Esto le permite escribir un valor de parámetro en el control de entrada de texto.
nombre= 'num1''	Nombre del parámetro del método de servicios web. Agregue tantos controles de entradas de texto en el formulario como parámetros haya en el método de servicio web. Por ejemplo, si un método de servicio web tiene tres parámetros, se necesitan tres controles de entrada de texto y que cada uno tenga su conjunto de atributos de nombre establecido al nombre del parámetro.
type=submit	Agregue así un botón de envío que pueda devolver los datos al método de servicio web.

Tenga acceso a un explorador web y escriba la dirección URL para el documento HTML que creó en el paso anterior.

Se muestra el documento HTML creado en el paso anterior.
Especifique los valores adecuados para el método de servicio web en los cuadros de texto y haga clic en el botón de envío.

Por ejemplo, si escribió 6 y a continuación 3 en los dos cuadros de texto para el método de servicio web Subtract del ejemplo, se devuelve el resultado siguiente:
```
<?xml version="1.0" ?> 
<int xmlns="http://tempuri.org/">3</int>
```

Consulte también

Cómo: Tener acceso a servicios web XML desde un explorador

Para probar un servicio web en un explorador utilizando HTTP-GET

Para probar directamente un método de servicio web en un explorador utilizando HTTP-GET

Para probar un servicio web en un explorador utilizando HTTP-POST

Consulte también

Tareas

Conceptos

Otros recursos

Recursos adicionales