SoapDocumentMethodAttribute.Use Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece el formato de los parámetros de un método de servicios Web XML en la parte XML de un mensaje 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 propiedad
SoapBindingUse para el método de servicios Web XML. De manera predeterminada, es Literal.
Ejemplos
En el ejemplo de código siguiente se especifica que Document
/ Encoded
los mensajes SOAP deben enviarse al método de PlaceOrder
servicio 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
Comentarios
El lenguaje de descripción de servicios web (WSDL) define dos métodos para dar formato a los parámetros: Encoded y Literal. Encoded hace referencia a los parámetros de formato mediante la codificación SOAP, como se describe en la especificación SOAP de la sección 5. Literal hace referencia al formato de los parámetros mediante un esquema XSD predefinido para cada parámetro.
Para obtener más información, consulte Personalización del formato de mensajes SOAP.