Cómo: Explorar el contenido de un servicio web

Actualización: noviembre 2007

El archivo .asmx representa el punto de entrada direccionable de los servicios web creados con código administrado. El modo de tener acceso a este archivo mediante HTTP determina el tipo de respuesta que se reciba.

Página de ayuda del servicio

Cuando se llama al archivo .asmx desde un explorador web sin especificar una cadena de consulta reconocida, éste devuelve una página de ayuda del servicio generada automáticamente para el servicio web. Esto es lo mismo que hacer un HTTP GET en el archivo .asmx.

Esta página de ayuda del método de servicio contiene una lista de los métodos que proporciona el servicio web y a los que se puede tener acceso mediante programación. Esta página contiene vínculos en cada método que remiten a información adicional sobre dicho método. Esta página contiene además un vínculo al documento de descripción del servicio web.

Para tener acceso a la página de ayuda del servicio

• En el campo Dirección del explorador, escriba la dirección URL base del servicio web con este formato:

  https://servername/projectname/webservicename.asmx
  

  Parameter	Valor
  servername	Servidor donde reside el servicio web.
  projectname	Nombre del proyecto del servicio web y cualquier información de directorio adicional necesaria para obtener acceso al archivo .asmx del servicio web.
  webservicename.asmx	Nombre del archivo .asmx del servicio web.

  Por ejemplo, para tener acceso a un servicio web denominado Service1.asmx que forma parte de un proyecto denominado WebService1 en el equipo local, se especificaría lo siguiente:

  https://localhost/WebService1/Service1.asmx
  

La página de ayuda del método de servicio contiene información adicional relativa a este método de servicio web en particular.

La página ofrece la posibilidad de invocar el método utilizando el protocolo HTTP-POST. Sin embargo, el método de servicio web debe admitir el protocolo HTTP-POST para poder utilizar esta funcionalidad.

En la parte inferior de la página, la página de ayuda del método de servicio incluye ejemplos de mensajes de solicitud y respuesta para los protocolos compatibles con el método de servicio web.

Descripción del servicio

La página de ayuda de servicio ofrece también un vínculo a la descripción de servicios del servicio web, que es una definición formal de las capacidades del servicio web. La descripción de servicios es un documento que utiliza la gramática del Lenguaje de descripción del servicio Web (WSDL). La descripción de servicios define el contrato de los formatos de mensaje que deben seguir los clientes al intercambiar mensajes con el servicio web. Para obtener más información, vea Descripción del servicio web XML.

Para tener acceso a la descripción de servicios

• En el campo Dirección del explorador, escriba la dirección URL base del servicio web y especifique la cadena de consulta WSDL con este formato:

  https://servername/projectname/webservicename.asmx?WSDL
  

  Parameter	Valor
  servername	Servidor donde reside el servicio web.
  projectname	Nombre del proyecto del servicio web y cualquier información de directorio adicional necesaria para obtener acceso al archivo .asmx del servicio web.
  webservicename.asmx	Nombre del archivo .asmx del servicio web.

  Por ejemplo, para tener acceso a la descripción de servicios de un servicio web que se denomina Service1.asmx y que forma parte de un proyecto denominado WebService1 en el equipo local, se especificaría lo siguiente:

  https://localhost/WebService1/Service1.asmx?WSDL
  

Obtener acceso a los servicios web desde un explorador web

Desde un explorador web se puede tener acceso a un servicio web compatible con el protocolo HTTP-GET. De forma predeterminada, los servicios web creados en Visual Studio con la plantilla de proyecto de servicio web ASP.NET admiten HTTP-GET, HTTP-POST y HTTP-SOAP. Algunos protocolos no son compatibles con todos los métodos. En general, los protocolos HTTP-GET y HTTP-POST están más restringidos que HTTP-SOAP en los tipos de datos que admiten.

Para tener acceso a un servicio web desde un explorador web

• En el campo Dirección del explorador, escriba la dirección URL base del servicio web con los parámetros y el nombre del método en la cadena de consulta utilizando el siguiente formato:

  https://servername/projectname/webservicename.asmx/methodname?parametername0=value0&parametername1=value1&...&parameternamen=valuen
  

  Parameter	Valor
  servername	Servidor donde reside el servicio web.
  projectname	Nombre del proyecto del servicio web y cualquier información de directorio adicional necesaria para obtener acceso al archivo .asmx del servicio web.
  webservicename.asmx	Nombre del archivo .asmx del servicio web.
  methodname	El nombre del método Web, con distinción entre mayúsculas y minúsculas.
  parametername	Los nombres de los parámetros de método Web.
  Valor	Los valores codificados de dirección URL de cada parámetro del método Web.

  Por ejemplo, para tener acceso al método ReturnThisString de un servicio web denominado Service1.asmx con un parámetro denominado MyString establecido en un valor de “This is my test string” y que forma parte de un proyecto con el nombre WebService1 en el equipo local, se especificaría lo siguiente:

  https://localhost/WebService1/Service1.asmx/ReturnThisString?MyString=This+is+my+test+string
  

Vea también

Conceptos

Descripción del servicio web XML

Otros recursos

Crear servicios web en código administrado