SoapDocumentMethodAttribute.Use Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define a formatação de parâmetros para um método de serviço Web XML dentro da 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 de Propriedade
O SoapBindingUse para o método do serviço Web XML. A predefinição é Literal.
Exemplos
O exemplo de código seguinte especifica que Document / Encoded as mensagens SOAP devem ser enviadas para o PlaceOrder método de 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
Observações
A Linguagem de Descrição de Serviços Web (WSDL) define dois métodos para parâmetros de formatação: Encoded e Literal. Encoded refere-se a parâmetros de formatação usando a codificação SOAP, conforme descrito na especificação SOAP na secção 5. Literal refere-se à formatação dos parâmetros usando um esquema XSD pré-definido para cada parâmetro.
Para mais detalhes, consulte Personalização da Formatação de Mensagens SOAP.