SoapDocumentMethodAttribute.Use Eigenschaft

Definition

Namespace:

System.Web.Services.Protocols

Assembly:

System.Web.Services.dll

Ruft die Parameterformatierung für eine XML-Webdienstmethode innerhalb des XML-Teils einer SOAP-Nachricht ab oder legt diese fest.

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

SoapBindingUse

Die SoapBindingUse für die XML-Webdienstmethode. Der Standardwert ist Literal.

Beispiele

Im folgenden Codebeispiel wird angegeben, dass Document / Encoded SOAP-Nachrichten an die PlaceOrder XML-Webdienstmethode gesendet werden müssen.

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

Die Web Services Description Language (WSDL) definiert zwei Methoden für formatierungsparameter: Encoded und Literal. Encoded bezieht sich auf Formatierungsparameter mit SOAP-Codierung, wie in der SOAP-Spezifikation in Abschnitt 5 beschrieben. Literal bezieht sich auf das Formatieren der Parameter mithilfe eines vordefinierten XSD-Schemas für jeden Parameter.

Weitere Informationen finden Sie unter Anpassen der SOAP-Nachrichtenformatierung.

Weitere Informationen

• SoapBindingUse
• Anpassen der Formatierung von SOAP-Nachrichten