Commentaires non présents dans Reference.cs

**Larger** · 20/11/2009, 11h16

Bonjour,

J'utilise les 3 slashs pour commenter le code d'un web service. Je génère le XML de documentation, il contient toute la documentation écrite.

Je teste ensuite l'utilisation du web service par un nouveau projet. J'y ajoute la web référence correspondante (http:localhost:port/). Jusqu'ici tout fonctionne, je peux accéder aux fonctions du web service.

Seulement la documentation n'y figure plus. Lorsque j'ouvre le Reference.cs généré automatiquement, j'obtiens ceci :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
        /// <remarks/>
        public object Get(int param1, int param2) {
            ///contenu de la méthode
        }

(Il va de soit que j'ai simplifié la méthode)

Mes commentaires n'apparaissent plus et j'ai seulement un <remarks/> qui n'est pas dans mon web service.
Voici un exemple de méthode du web service :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
		/// <summary>
		/// Ceci est un test
		/// </summary>
		[WebMethod(Description = "blabla)")]
                          [doc.Request]
		public object Get(int param1, int param2)
		{
			//blabla
		}

Pourquoi les commentaires de mon web service ne sont-ils pas repris dans le reference.cs ?
Merci pour votre attention.

**bacelar** · 21/11/2009, 18h34

Car ils ne sont pas présents dans le WSDL de votre Web Service.
Il faut bien comprendre que les Web Service permettent à de multiple environnement comme .NET, VM JAVA, code natifs etc. d'interagir.

Sinon, un appel direct aux classes .NET serait beaucoup plus simple.

Donc les bonnes questions sont :
Comment faire en sorte que mes commentaires soient présents dans le WSDL de mon Web Service ? (je ne suis pas sûr que cela soit possible)
Si c'est possible, comment demander à mon générateur de proxy, wsdl.exe, de récupérer ces commentaires dans le WSDL dans les classes générées ?

Je ne peux répondre à aucune des 2, mais peut-être que cela vous aidera à trouver des réponses sur le Net.

**Larger** · 23/11/2009, 11h29

Bonjour,

Effectivement maintenant que tu le dis, ça me paraît évident. J'étais même en train de voir comment modifier la wsdl pour y ajouter plus de commentaires.

Apparemment pour les deux questions que tu as formulé, ça semble tout à fait faisable. Je vais potasser ça un peu plus et poster à la suite ce que j'aurais trouvé.

Merci pour tes éclaircissements.