SoapHttpClientProtocol, classe

Si vous générez un client de service Web XML, une classe proxy dérivant directement ou indirectement de WebClientProtocol doit être créée pour le service Web XML. Si le client de service Web XML utilise SOAP pour l'appel, la classe proxy doit dériver de SoapHttpClientProtocol, qui est dérivé de HttpWebClientProtocol. HttpWebClientProtocol dérive, à son tour, de WebClientProtocol.

Pour communiquer avec un service Web XML, créez une classe proxy indirectement ou directement dérivée de WebClientProtocol pour le service Web XML à appeler. Au lieu de créer la classe proxy manuellement, ayez recours à l'outil Wsdl.exe (Web Services Description Language) afin de créer une classe proxy pour une description d'un service Web XML donné. Si une classe proxy est générée pour le protocole SOAP, les appels synchrones aux méthodes de services Web XML sont lancés à l'aide de la méthode Invoke, alors que les appels asynchrones sont lancés à l'aide des méthodes BeginInvoke et EndInvoke.

Si vous substituez cette classe, vous pouvez introduire dans la classe dérivée des méthodes spécifiques à un type particulier de service Web XML. Les méthodes capturent les paramètres et appellent la classe de base pour qu'elle se charge des communications avec le service Web XML. Si les méthodes introduites sont asynchrones, appelez les méthodes BeginInvoke et EndInvoke. Si les méthodes introduites sont synchrones, appelez la méthode Invoke. Le constructeur substitué affecte généralement comme valeur à la propriété Url l'URL de la méthode de service Web XML.

L'exemple de code suivant est une classe proxy générée par Wsdl.exe pour le service Web XML Math. La classe proxy dérive de SoapHttpClientProtocol, qui dérive de la classe WebClientProtocol abstraite.

namespace MyMath {
    using System.Diagnostics;
    using System.Xml.Serialization;
    using System;
    using System.Web.Services.Protocols;
    using System.Web.Services;


    [System.Web.Services.WebServiceBindingAttribute(Name="MyMathSoap", Namespace="http://www.contoso.com/")]
    public class MyMath : System.Web.Services.Protocols.SoapHttpClientProtocol {

        [System.Diagnostics.DebuggerStepThroughAttribute()]
        public MyMath() {
            this.Url = "http://www.contoso.com/math.asmx";
        }

        [System.Diagnostics.DebuggerStepThroughAttribute()]
        [System.Web.Services.Protocols.SoapDocumentMethodAttribute("http://www.contoso.com/Add", RequestNamespace="http://www.contoso.com/", ResponseNamespace="http://www.contoso.com/", Use=System.Web.Services.Description.SoapBindingUse.Literal, ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped)]
        public int Add(int num1, int num2) {
            object[] results = this.Invoke("Add", new object[] {num1,
                        num2});
            return ((int)(results[0]));
        }

        [System.Diagnostics.DebuggerStepThroughAttribute()]
        public System.IAsyncResult BeginAdd(int num1, int num2, System.AsyncCallback callback, object asyncState) {
            return this.BeginInvoke("Add", new object[] {num1,
                        num2}, callback, asyncState);
        }

        [System.Diagnostics.DebuggerStepThroughAttribute()]
        public int EndAdd(System.IAsyncResult asyncResult) {
            object[] results = this.EndInvoke(asyncResult);
            return ((int)(results[0]));
        }
    }
}

L'exemple de code suivant est le service Web XML Math, à partir duquel la classe proxy précédente a été générée.

Note de sécurité
Cet exemple a une zone de texte qui accepte l'entrée d'utilisateur, ce qui constitue une menace éventuelle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que les entrées d'utilisateur n'incluent pas de script ou d'éléments HTML. Pour plus d'informations, consultez Script Exploits Overview.

<%@ WebService Language="C#" Class="MyMath"%>
 using System.Web.Services;
 using System;

 [WebService(Namespace="http://www.contoso.com/")] 
 public class MyMath {
      [ WebMethod ]
      public int Add(int num1, int num2) {
          return num1+num2;
          }
 }

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Ce type est thread-safe.

Référence