SoapDocumentMethodAttribute.Use Propriété

Définition

Espace de noms:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Obtient ou définit la mise en forme des paramètres d'une méthode de service Web XML dans la portion XML d'un message SOAP.

public:
 property System::Web::Services::Description::SoapBindingUse Use { System::Web::Services::Description::SoapBindingUse get(); void set(System::Web::Services::Description::SoapBindingUse value); };

public System.Web.Services.Description.SoapBindingUse Use { get; set; }

member this.Use : System.Web.Services.Description.SoapBindingUse with get, set

Public Property Use As SoapBindingUse

Valeur de propriété

SoapBindingUse

SoapBindingUse de la méthode de service Web XML. La valeur par défaut est Literal.

Exemples

L’exemple de code suivant spécifie que Document / Encoded les messages SOAP doivent être envoyés à la méthode de PlaceOrder service Web XML.

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

 public class ShoppingCart 
 {
       [ SoapDocumentMethod(Use=SoapBindingUse.Encoded) ]
       [ WebMethod]
       public void PlaceOrder(OrderItem O) 
       {
        // Process the order on the back end.
       }      
 }

public class OrderItem
{
  public int Count;
  public int Description;
  public DateTime OrderDate;
  public long CustomerID;
  public Decimal Cost;
}

<%@ WebService Language="VB" Class="ShoppingCart" %>
 
Imports System.Web.Services
Imports System.Web.Services.Protocols
Imports System.Web.Services.Description
Imports System

Public Class ShoppingCart
        
    ' Specify that the XML Web service method uses encoded SOAP messages.
    <SoapDocumentMethod(Use:=SoapBindingUse.Encoded), _
     WebMethod()> _
    Public Sub PlaceOrder(O as OrderItem)
        
        ' Process the order on the back end.
    End Sub
End Class

Public Class OrderItem
  Public Count As Integer
  Public Description as String
  Public OrderDate as DateTime
  Public CustomerID as Long
  Public Cost as Decimal

End Class

Remarques

Le langage WSDL (Web Services Description Language) définit deux méthodes pour la mise en forme des paramètres : Encoded et Literal. Encoded fait référence à la mise en forme des paramètres à l’aide de l’encodage SOAP, comme indiqué dans la spécification SOAP de la section 5. Literal fait référence à la mise en forme des paramètres à l’aide d’un schéma XSD prédéfini pour chaque paramètre.

Pour plus d’informations, consultez Personnalisation de la mise en forme des messages SOAP.

Voir aussi

• SoapBindingUse
• Personnalisation de la mise en forme de messages SOAP