Procédure pas à pas : accès à un service Web XML en utilisant Visual Basic ou Visual C#

Dans le menu Fichier, cliquez sur Nouveau site Web.

Dans la boîte de dialogue Nouveau site Web, sélectionnez l'icône Site Web ASP.NET.

Entrez l'adresse du serveur Web sur lequel vous allez développer l'application Web et spécifiez TempConvertClient1 comme nom de répertoire (par exemple "http://MonServeur/TempConvertClient1"). Par défaut, le projet utilise votre ordinateur local, "http://localhost".

Remarque
Pour certains types de projets, la zone de texte Nom n'est pas disponible, car le nom du projet est défini automatiquement lorsque vous spécifiez son emplacement. Par exemple, les applications Web et les services Web XML se trouvent sur un serveur Web et dérivent leur nom du répertoire virtuel spécifié sur ce serveur.

Remarque

Les applications Web sont développées sur un serveur de développement. Par défaut, le serveur de développement est votre ordinateur local. En règle générale, vous développez et générez le projet sur un serveur de développement, puis vous le déployez sur un autre serveur (le serveur de déploiement) qui héberge l'application Web au moyen d'un projet de déploiement. Toutefois, si vous développez directement sur le serveur qui héberge l'application Web, le serveur de développement est identique au serveur de déploiement.

Cliquez sur OK pour créer le projet.

Dans l'Explorateur de solutions, cliquez avec le bouton droit sur Default.aspx et choisissez Concepteur de vues pour ouvrir le concepteur.

Sous l'onglet Web Forms de la boîte à outils, faites glisser une Zone de texte, une Étiquette et un Bouton jusqu'à l'aire de conception de Default.aspx et arrangez ces éléments à votre convenance.

Cliquez avec le bouton droit sur le bouton que vous avez ajouté, Button1, et cliquez sur Propriétés dans le menu contextuel. Dans la fenêtre Propriétés, attribuez à la propriété Text la valeur Convert.

Cliquez avec le bouton droit sur l'étiquette que vous avez ajoutée, Label1, et cliquez sur Propriétés dans le menu contextuel. Dans la fenêtre Propriétés, effacez la propriété Text pour créer une étiquette vide.

Dans le menu Site Web, cliquez sur Ajouter une référence Web.

Dans la zone URL de la boîte de dialogue Ajouter une référence Web, tapez l'URL permettant d'obtenir la description du service Web XML auquel vous voulez accéder, par exemple http://localhost/TempConvert1/service1.asmx. Cliquez ensuite sur le bouton Aller à pour récupérer des informations sur le service Web XML.

- ou -

Si le service Web XML existe sur l'ordinateur local, cliquez sur le lien Services Web sur l'ordinateur local dans le volet de navigation. Cliquez ensuite sur le lien du service Web XML TempConvert1 dans la liste fournie pour récupérer des informations sur ce service Web XML.

Dans la zone Nom de la référence Web, renommez la référence Web en ConvertSvc, qui est l'espace de noms que vous utiliserez pour accéder à cette référence Web.

Cliquez sur Ajouter une référence pour ajouter une référence Web au service Web XML cible. Pour plus d'informations, consultez Ajout et suppression de références Web.

Visual Studio télécharge la description de service et génère une classe proxy pour se connecter à votre application et au service Web XML.

Double-cliquez sur le bouton Convertir dans WebForm1.aspx pour créer une méthode de gestion d'événements pour ce bouton et pour afficher le fichier code-behind.

Entrez le code suivant :

' Visual Basic
Protected Sub Button1_Click(ByVal sender As Object, _
  ByVal e as EventArgs) Handles Button1.Click
    Dim ws As New ConvertSvc.Service
    Dim dFahrenheit As Double
    Dim dCelsius As Double
    Try
        dFahrenheit = Convert.ToDouble(TextBox1.Text)
        dCelsius = ws.ConvertTemperature(dFahrenheit)
        Label1.Text = dCelsius.ToString()
    Catch
        Label1.Text = "Conversion failed."
    End Try
End Sub

// C#
protected void Button1_Click (System.Object sender, System.EventArgs e)
{
   try
   {
      ConvertSvc.Service1 ws = new ConvertSvc.Service1();
      double dFahrenheit = Convert.ToDouble(TextBox1.Text);
      double dCelsius = ws.ConvertTemperature(dFahrenheit);
      Label1.Text = dCelsius.ToString();
   }
   catch
   {
      Label1.Text = "Conversion failed.";
   }
}

Remarque
Le nom de la classe de service Web XML générée lors de l'ajout d'une référence Web peut être différent de celui qui est affiché ci-dessus en tant que Service1.

Sélectionnez Default.aspx dans l'Explorateur de solutions.

Dans le menu Site Web, cliquez sur Définir comme page de démarrage.

Enregistrez la solution.

Dans le menu Déboguer, cliquez sur Nouveau point d'arrêt, puis sélectionnez Interrompre à la fonction.

Tapez Button1_Click dans la zone Function, puis cliquez sur OK pour placer un point d'arrêt sur le gestionnaire d'événements Button1_Click. Pour plus d'informations, consultez Vue d'ensemble des points d'arrêt.

Dans le menu Déboguer, cliquez sur Démarrer, puis sur OK dans la fenêtre Débogage non activé pour démarrer le débogage.

Cette commande ordonne à Visual Studio d'exécuter l'application Web dans le débogueur. Visual Studio génère le projet et le déploie sur le serveur de développement spécifié. Au terme de l'exécution, le navigateur par défaut est lancé et navigue jusqu'au fichier .aspx sur le serveur de déploiement.

Dès que la page s'affiche dans le navigateur, tapez le nombre 212 dans la zone de texte, puis cliquez sur le bouton Convertir.

Lorsque le traitement atteint le gestionnaire d'événements Button1_Click, il s'arrête. Le débogueur Visual Studio met en surbrillance la ligne contenant le point d'arrêt et, lors de l'arrêt, vous permet d'effectuer plusieurs tâches. Pour plus d'informations, consultez Utilisation du débogueur et Outils de débogage pour l'examen de votre programme.

Dans le menu Déboguer, cliquez sur Continuer pour poursuivre le traitement.

Le service Web XML répond en retournant la valeur convertie, et l'application définit le texte de Label1 à la valeur 100.

Pour mettre fin à l'exécution de l'application Web et retourner dans l'éditeur de code, dans le menu Déboguer, cliquez sur Arrêter le débogage.

Dans le menu Déboguer, cliquez sur Effacer tous les points d'arrêt.

Dans le menu Fichier, pointez sur Ajouter, puis cliquez sur New Projet.

Sélectionnez le nœud Autre, puis le nœud Projets d'installation et de déploiement, puis cliquez sur Projet d'installation Web.

Dans la zone Nom, tapez TempConvertClient1WebSetup, puis cliquez sur OK.

Remarque
Par défaut, le programme d'installation utilise le nom du projet de déploiement lors de la création du répertoire virtuel sur votre serveur de déploiement.

Dans le volet de gauche de l'Éditeur du système de fichiers, sélectionnez Dossier d'application Web. Pour plus d'informations, consultez Éditeur du système de fichiers.

Dans l'Explorateur de solutions, cliquez avec le bouton droit sur TempConvertClient1WebSetup, pointez sur Ajouter, puis cliquez sur Sortie du projet.

Dans la boîte de dialogue Ajouter le groupe de sorties du projet, sélectionnez Content Files. Pour plus d'informations, consultez Ajout et suppression de sorties de projet dans l'Éditeur du système de fichiers.

• Le groupe Fichiers de contenu se compose des fichiers restants pour l'application Web, notamment WebForm1.aspx et Web.config.

Cliquez sur OK.

Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le projet TempConvertClient1WebSetup, puis, dans le menu contextuel, cliquez sur Générer.

Vous créez ainsi un fichier Windows Installer dans le répertoire du projet local. L'exécution de ce fichier installe l'application Web.

Dans l'Explorateur de solutions, sélectionnez le projet TempConvertClient1.

Dans le menu Projet, cliquez sur Copier le site Web.

Cliquez sur l'icône située en regard de la zone déroulante Connexion : pour ouvrir la boîte de dialogue Ouvrir le site Web. Accédez à l'emplacement auquel vous souhaitez copier le projet.

Dans le volet Site Web source, sélectionnez les fichiers à copier et déplacez-les vers le volet Site Web distant en cliquant sur l'icône de flèche pointant vers la droite.

Cliquez sur Copier le site Web pour copier le site Web.