SoapDocumentMethodAttribute.Use プロパティ

.NET Framework クラス ライブラリ リファレンス

SoapDocumentMethodAttribute.Use プロパティ

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

名前空間: System.Web.Services.Protocols
アセンブリ: System.Web.Services (system.web.services.dll 内)
構文

Visual Basic (宣言)

Public Property Use As SoapBindingUse

Visual Basic (使用法)

Dim instance As SoapDocumentMethodAttribute
Dim value As SoapBindingUse

value = instance.Use

instance.Use = value

C#

public SoapBindingUse Use { get; set;
 }

C++

public:
property SoapBindingUse Use {
    SoapBindingUse get ();
    void set (SoapBindingUse value);
}

J#

/** @property */
public SoapBindingUse get_Use ()

/** @property */
public void set_Use (SoapBindingUse value)

JScript

public function get Use
 () : SoapBindingUse

public function set Use
 (value : SoapBindingUse)

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

解説

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

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

使用例

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

Visual Basic

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SoapDocumentMethodAttribute クラス
SoapDocumentMethodAttribute メンバ
System.Web.Services.Protocols 名前空間
SoapBindingUse 列挙体
その他の技術情報
SOAP メッセージ形式のカスタマイズ