SoapDocumentMethodAttribute.Use Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví formátování parametru pro xml webové služby metoda v xml část soap zprávy.
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
Hodnota vlastnosti
Pro SoapBindingUse metodu webové služby XML. Výchozí formát je Literal.
Příklady
Následující příklad kódu určuje, že Document
/ Encoded
zprávy SOAP musí být odeslány PlaceOrder
do metody webové služby 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
Poznámky
WsDL (Web Services Description Language) definuje dvě metody formátování parametrů: Encoded a Literal. Encoded odkazuje na parametry formátování pomocí kódování SOAP, jak je uvedeno ve specifikaci SOAP v části 5. Literal odkazuje na formátování parametrů pomocí předdefinovaného schématu XSD pro každý parametr.
Další podrobnosti najdete v tématu Přizpůsobení formátování zpráv SOAP.