El archivo .asmx representa el punto de entrada direccionable de los servicios Web XML 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 XML. 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 XML 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 XML.
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 XML con este formato:
http://servername/projectname/xmlwebservicename.asmx
|
Parámetro
|
Valor
|
| servername | El servidor donde se encuentra el servicio Web XML. |
| projectname | El nombre del proyecto del servicio Web XML y cualquier información de directorio adicional necesaria para tener acceso al archivo .asmx del servicio Web XML. |
| webservicename.asmx | El nombre del archivo .asmx del servicio Web XML. |
Por ejemplo, para tener acceso a un servicio Web XML denominado Service1.asmx que forma parte de un proyecto denominado WebService1 en el equipo local, se especificaría lo siguiente:
http://localhost/XmlWebService1/Service1.asmx
La página de ayuda del método de servicio contiene información adicional relativa a este método Web XML 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 XML 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 XML.
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 XML, que es una definición formal de las capacidades del servicio Web XML. 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 XML. 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 XML y especifique la cadena de consulta WSDL con este formato:
http://servername/projectname/xmlwebservicename.asmx?WSDL
|
Parámetro
|
Valor
|
| servername | El servidor donde se encuentra el servicio Web XML. |
| projectname | El nombre del proyecto del servicio Web XML y cualquier información de directorio adicional necesaria para tener acceso al archivo .asmx del servicio Web XML. |
| webservicename.asmx | El nombre del archivo .asmx del servicio Web XML. |
Por ejemplo, para tener acceso a la descripción de servicios de un servicio Web XML que se denomina Service1.asmx y que forma parte de un proyecto denominado WebService1 en el equipo local, se especificaría lo siguiente:
http://localhost/XmlWebService1/Service1.asmx?WSDL
Obtener acceso a los servicios Web XML desde un explorador Web
Desde un explorador Web se puede tener acceso a un servicio Web XML compatible con el protocolo HTTP-GET. De forma predeterminada, los servicios Web XML 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 XML desde un explorador Web
-
En el campo Dirección del explorador, escriba la dirección URL base del servicio Web XML con los parámetros y el nombre del método en la cadena de consulta utilizando el siguiente formato:
http://servername/projectname/xmlwebservicename.asmx/methodname?parametername0=value0¶metername1=value1&...¶meternamen=valuen
|
Parámetro
|
Valor
|
| servername | El servidor donde se encuentra el servicio Web XML. |
| projectname | El nombre del proyecto del servicio Web XML y cualquier información de directorio adicional necesaria para tener acceso al archivo .asmx del servicio Web XML. |
| webservicename.asmx | El nombre del archivo .asmx del servicio Web XML. |
| 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 XML 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:
http://localhost/XmlWebService1/Service1.asmx/ReturnThisString?MyString=This+is+my+test+string
Vea también