SoapDocumentMethodAttribute.Use プロパティ

SOAP メッセージの XML 部分内にある XML Web サービス メソッドのパラメータの書式を取得または設定します。

Public Property Use As SoapBindingUse
[C#]
public SoapBindingUse Use {get; set;}
[C++]
public: __property SoapBindingUse get_Use();public: __property void set_Use(SoapBindingUse);
[JScript]
public function get Use() : SoapBindingUse;public function set Use(SoapBindingUse);

プロパティ値

XML Web サービス メソッドの SoapBindingUse 。既定値は Literal です。

解説

Web サービス記述言語 (WSDL: Web Services Description Language) では、パラメータの書式として Encoded と Literal の 2 つのスタイルが定義されています。 Encoded は、SOAP 仕様のセクション 5 に概説されている SOAP エンコーディングを使用したパラメータの書式指定を表します。 Literal は、パラメータごとに定義済みの XSD スキーマを使用したパラメータの書式指定を表します。

詳細については、「 SOAP メッセージのカスタマイズ 」を参照してください。

使用例

[Visual Basic, C#] Document/ Encoded SOAP メッセージを PlaceOrder XML Web サービス メソッドに送信するように指定するコード例を次に示します。

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

[C#] 
<%@ 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;
}

[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

SoapDocumentMethodAttribute クラス | SoapDocumentMethodAttribute メンバ | System.Web.Services.Protocols 名前空間 | SoapBindingUse | SOAP メッセージのカスタマイズ