SoapDocumentMethodAttribute.Use Propriedade

Definição

Namespace:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Obtém ou define a formatação de parâmetro de um método de serviço Web XML na parte XML de uma mensagem 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

Valor da propriedade

SoapBindingUse

O SoapBindingUse do método de serviço Web XML. O padrão é Literal.

Exemplos

O exemplo de código a seguir especifica que Document / Encoded as mensagens SOAP devem ser enviadas para o método de PlaceOrder serviço 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

Comentários

A Linguagem de Descrição dos Serviços Web (WSDL) define dois métodos para formatação de parâmetros: Encoded e Literal. Encoded refere-se a parâmetros de formatação usando a codificação SOAP, conforme descrito na especificação SOAP na seção 5. Literal refere-se à formatação dos parâmetros usando um esquema XSD predefinido para cada parâmetro.

Para obter mais detalhes, consulte Personalizando a formatação de mensagens SOAP.

Confira também

• SoapBindingUse
• Personalizando a formatação de mensagens SOAP