Comment : explorer du contenu d'un service Web

Mise à jour : novembre 2007

Le fichier .asmx représente le point d'entrée adressable des services Web créés en code managé. La façon dont vous y accédez via le protocole HTTP détermine le type de réponse que vous obtenez.

Page d'aide du service

Lorsque le fichier .asmx est appelé à partir d'un navigateur Web sans fournir une chaîne de requête identifiée, il retourne une page d'aide du service, automatiquement générée et correspondant au service Web. Il s'agit là d'un équivalent à l'instruction HTTP GET sur le fichier .asmx.

Cette page d'aide de la méthode du service contient la liste des méthodes que le service Web fournit et auxquelles vous pouvez accéder par programmation. Elle contient pour chaque méthode des liens vers des informations complémentaires. En outre, elle propose un lien vers le document de description du service Web.

Pour accéder à la page d'aide du service

• Dans le champ Adresse du navigateur, tapez l'URL de base du service Web en respectant le format suivant :

  https://servername/projectname/webservicename.asmx
  

  Paramètre	Valeur
  servername	Serveur sur lequel réside le service Web.
  projectname	Nom du projet correspondant à votre service Web et toute information de répertoire complémentaire nécessaire pour accéder au fichier .asmx de votre service Web.
  webservicename.asmx	Nom du fichier .asmx du service Web.

  Par exemple, pour accéder à un service Web intitulé Service1.asmx faisant lui-même partie du projet WebService1 sur votre ordinateur local, vous devez entrer la commande suivante :

  https://localhost/WebService1/Service1.asmx
  

Cette page d'aide fournit des informations complémentaires ayant rapport avec cette méthode de service Web particulière.

Elle permet d'appeler la méthode à l'aide du protocole HTTP-POST. Cependant, la méthode de service Web doit prendre en charge le protocole HTTP-POST pour que cette fonctionnalité puisse être activée.

En bas de la page, la page d'aide de la méthode du service fournit des exemples de demandes et de réponses correspondant aux protocoles pris en charge par la méthode de service Web.

Description du service

La page d'aide du service contient également un lien vers la description du service Web, qui est une définition formelle des possibilités offertes par ce service Web. La description du service est un document utilisant la syntaxe WSDL (Web Services Description Language). Cette description définit le contrat auquel doivent se soumettre les clients des formats de messages lors de l'échange de messages avec le service Web. Pour plus d'informations, consultez Description de service Web XML.

Pour accéder à la description du service

• Dans le champ Adresse de votre navigateur, tapez l'URL de base du service Web et indiquez la chaîne de requête WSDL en respectant le format suivant :

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

  Paramètre	Valeur
  servername	Serveur sur lequel réside le service Web.
  projectname	Nom du projet correspondant à votre service Web et toute information de répertoire complémentaire nécessaire pour accéder au fichier .asmx de votre service Web.
  webservicename.asmx	Nom du fichier .asmx du service Web.

  Par exemple, pour accéder à la description de service d'un service Web intitulé Service1.asmx faisant lui-même partie du projet WebService1 sur votre ordinateur local, vous devez entrer la commande suivante :

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

Accès aux services Web à partir d'un navigateur Web

Il est possible d'accéder à partir d'un navigateur Web à un service Web prenant en charge le protocole HTTP-GET. Par défaut, les services Web que vous créez dans Visual Studio à l'aide du modèle de projet de service Web ASP.NET prennent en charge les protocoles HTTP-GET, HTTP-POST et HTTP-SOAP. Tous les protocoles ne prennent pas en charge toutes les méthodes. En général, les protocoles HTTP-GET et HTTP-POST sont plus restrictifs que le protocole HTTP-SOAP quant aux types de données qu'ils prennent en charge.

Pour accéder à un service Web à partir d'un navigateur Web

• Dans le champ Adresse de votre navigateur, tapez l'URL de base du service Web et indiquez la chaîne de requête avec le nom de la méthode et les paramètres en respectant le format suivant :

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

  Paramètre	Valeur
  servername	Serveur sur lequel réside le service Web.
  projectname	Nom du projet correspondant à votre service Web et toute information de répertoire complémentaire nécessaire pour accéder au fichier .asmx de votre service Web.
  webservicename.asmx	Nom du fichier .asmx du service Web.
  methodname	Nom de la méthode Web. Ce nom respecte la casse.
  parametername	Noms des paramètres de la méthode Web.
  value	Valeurs codées de l'URL de chacun des paramètres de la méthode Web.

  Par exemple, pour accéder à la méthode ReturnThisString d'un service Web intitulé Service1.asmx avec le paramètre MyString ayant la valeur « This is my test string », ce service faisant lui-même partie du projet WebService1 sur votre ordinateur local, vous devez entrer la commande suivante :

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

Voir aussi

Concepts

Description de service Web XML

Autres ressources

Création de services Web en code managé