SoapRpcServiceAttribute クラス
オプションの SoapRpcServiceAttribute を XML Web サービスに適用することにより、そのサービス内の XML Web サービス メソッドとの間で送受信される SOAP 要求と SOAP 応答の既定の書式を設定できます。
この型のすべてのメンバの一覧については、SoapRpcServiceAttribute メンバ を参照してください。
System.Object
System.Attribute
System.Web.Services.Protocols.SoapRpcServiceAttribute
<AttributeUsage(AttributeTargets.Class)>
NotInheritable Public Class SoapRpcServiceAttribute Inherits Attribute
[C#]
[AttributeUsage(AttributeTargets.Class)]
public sealed class SoapRpcServiceAttribute : Attribute
[C++]
[AttributeUsage(AttributeTargets::Class)]
public __gc __sealed class SoapRpcServiceAttribute : public Attribute
[JScript]
public
AttributeUsage(AttributeTargets.Class)
class SoapRpcServiceAttribute extends Attribute
スレッドセーフ
この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。
解説
SoapRpcServiceAttribute を使用すると、XML Web サービス内で、XML Web サービス メソッドの既定のエンコーディング スタイルとして、メソッドについては RPC エンコーディング、パラメータについては Encoded エンコーディングを設定できます。
Web サービス記述言語 (WSDL: Web Services Description Language) では、操作を呼び出す XML Web サービス メソッドの SOAP 要求または SOAP 応答におけるエンコード方式として、 RPC と Document の 2 つのスタイルを定義しています。 RPC スタイルは、SOAP 仕様の RPC としての SOAP の使用に関する規定 (SOAP 仕様のセクション 7) に従った XML Web サービス メソッドのエンコーディングを示します。このスタイルは、XML Web サービス メソッドの名前が付いている単一の XML 要素内にすべてのパラメータをカプセル化し、その XML 要素内の各 XML 要素が各パラメータを表し、各要素にはそれぞれが表すパラメータの名前が付けられることを指定します。
メソッド レベルの既定のエンコーディングを Document に設定するには、XML Web サービスを実装するクラスに SoapDocumentServiceAttribute を適用します。
詳細については、「 SOAP メッセージのカスタマイズ 」を参照してください。
この属性は、XML Web サービスを実装しているクラスに適用できます。
使用例
<%@ WebService Language="VB" Class="SumService" %>
Imports System
Imports System.Web.Services
Imports System.Web.Services.Protocols
Imports System.Web.Services.Description
<SoapRpcServiceAttribute(RoutingStyle:=SoapServiceRoutingStyle.SoapAction)> _
Public Class SumService
Inherits System.Web.Services.WebService
<WebMethod> _
Public Function Add(a As Integer, b as Integer)
return a + b
End Function
End Class
[C#]
<%@ WebService Language="c#" Class="SumService" %>
using System;
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Web.Services.Description;
[SoapRpcService(RoutingStyle=SoapServiceRoutingStyle.SoapAction)]
public class SumService : System.Web.Services.WebService
{
[WebMethod]
public int Add(int a, int b)
{
return a + b;
}
}
[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
名前空間: System.Web.Services.Protocols
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
アセンブリ: System.Web.Services (System.Web.Services.dll 内)
参照
SoapRpcServiceAttribute メンバ | System.Web.Services.Protocols 名前空間 | SoapDocumentServiceAttribute | SoapRpcMethodAttribute | SoapBindingUse | SoapServiceRoutingStyle