SoapDocumentMethodAttribute.Use Eigenschaft

Definition

Ruft die Parameterformatierung für eine XML-Webdienstmethode innerhalb des XML-Teils einer SOAP-Nachricht ab oder legt diese fest.Gets or sets the parameter formatting for an XML Web service method within the XML portion of a SOAP message.

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

Eigenschaftswert

Die SoapBindingUse für die XML-Webdienstmethode.The SoapBindingUse for the XML Web service method. Der Standardwert lautet Literal.The default is Literal.

Beispiele

Im folgenden Codebeispiel wird angegeben, dass Document / Encoded SOAP-Nachrichten an die PlaceOrder XML-Webdienst Methode gesendet werden müssen.The following code example specifies that Document / Encoded SOAP messages must be sent to the PlaceOrder XML Web service method.

<%@ 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

Hinweise

Der Web Services Description Language (WSDL) definiert zwei Methoden zum Formatieren von Parametern: Encoded und Literal.The Web Services Description Language (WSDL) defines two methods for formatting parameters: Encoded and Literal. Encoded bezieht sich auf die Formatierung von Parametern mithilfe der SOAP-Codierung, wie in der SOAP-Spezifikation in Abschnitt 5 beschrieben.Encoded refers to formatting parameters using SOAP encoding, as outlined in the SOAP specification in section 5. Literal bezieht sich auf das Formatieren der Parameter mithilfe eines vordefinierten XSD-Schemas für jeden Parameter.Literal refers to formatting the parameters using a pre-defined XSD schema for each parameter.

Weitere Informationen finden Sie unter Anpassen der Formatierung von SOAP-Nachrichten.For more details, see Customizing SOAP Message Formatting.

Gilt für:

Siehe auch