Comment : modifier le format SOAP par défaut pour l'intégralité d'un service Web

Cette rubrique est spécifique à une technologie existante. Les services Web XML et les clients du service Web XML doivent à présent être créés à l'aide de Windows Communication Foundation.

Cette procédure décrit comment modifier la mise en forme SOAP par défaut pour un service Web entier.

Pour définir la méthode par défaut de mise en forme du style pour un service Web

1. Appliquez un attribut SoapRpcService ou un attribut SoapDocumentService à la classe qui implémente le service Web.

   L'exemple de code suivant affecte à la méthode de mise en forme du style la valeur Documente et au paramètre de mise en forme par défaut la valeur Literal, et spécifie que les paramètres doivent être encapsulés dans un seul élément.

   <%@ WebService Language="C#" Class="SoapDocumentServiceSample" %>
    using System.Web.Services;
    using System.Web.Services.Protocols;
    using System.Web.Services.Description;
   
   [SoapDocumentService(Use=SoapBindingUse.Literal,
                        ParameterStyle=SoapParameterStyle.Wrapped)]
   [WebService(Namespace="https://www.contoso.com")]
   public class SoapDocumentServiceSample  
   {
       [ WebMethod ]
       public string UseDefaultEncoding(Address MyAddress, 
                                        bool useZipPlus4) 
       {
        return "Use the default encodings for this Web service.";
       }
   }
   

   <%@ WebService Language="VB" Class="SoapDocumentServiceSample" %>
   Imports System.Web.Services
   Imports System.Xml.Serialization
   Imports System.Web.Services.Protocols
   Imports System.Web.Services.Description
   
   < SoapDocumentService(Use := SoapBindingUse.Literal, _
                         ParameterStyle := SoapParameterStyle.Wrapped)> _
   Public Class SoapDocumentServiceSample
     < WebMethod > _
     Public Function UseDefaultEncoding(MyAddress as Address, _
                                        useZipPlus4 As Boolean) As String 
        Return "Use the default formattings for this Web service."
     End Function
   End Class 
   

   La partie XML de la demande SOAP attendue par la méthode de service Web UseDefaultEncoding est indiquée ci-dessous.

   <?xml version="1.0" encoding="utf-8"?>
   <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                  xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/">
     <soap:Body>
       <UseDefaultEncoding xmlns="https://www.contoso.com">
         <MyAddress>
           <Street>string</Street>
           <City>string</City>
           <Zip>string</Zip>
         </MyAddress>
         <useZipPlus4>boolean</useZipPlus4>
       </UseDefaultEncoding>
     </soap:Body>
   </soap:Envelope>
   

Voir aussi

Référence

SoapDocumentServiceAttribute
SoapRpcServiceAttribute

Autres ressources

Personnalisation de la mise en forme de messages SOAP