SoapRpcServiceAttribute クラス

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

SoapRpcServiceAttribute クラス

XML Web サービス内の XML Web サービス メソッドとの間で送受信される SOAP 要求と SOAP 応答の既定の形式を設定します。

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

Visual Basic (宣言)

<AttributeUsageAttribute(AttributeTargets.Class)> _
Public NotInheritable Class
 SoapRpcServiceAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As SoapRpcServiceAttribute

C#

[AttributeUsageAttribute(AttributeTargets.Class)] 
public sealed class SoapRpcServiceAttribute
 : Attribute

C++

[AttributeUsageAttribute(AttributeTargets::Class)] 
public ref class SoapRpcServiceAttribute sealed
 : public Attribute

J#

/** @attribute AttributeUsageAttribute(AttributeTargets.Class) */ 
public final class SoapRpcServiceAttribute
 extends Attribute

JScript

AttributeUsageAttribute(AttributeTargets.Class) 
public final class SoapRpcServiceAttribute
 extends Attribute

解説

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 に設定するには、SoapDocumentServiceAttribute を XML Web サービスを実装しているクラスに適用します。

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

この属性は、XML Web サービスを実装しているクラスに適用できます。

使用例

SoapRpcServiceAttribute クラスを使用する方法の例を次に示します。

Visual Basic

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

継承階層

System.Object
   System.Attribute
    System.Web.Services.Protocols.SoapRpcServiceAttribute

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
SoapRpcServiceAttribute メンバ
System.Web.Services.Protocols 名前空間
SoapDocumentServiceAttribute クラス
SoapRpcMethodAttribute クラス
SoapBindingUse 列挙体
SoapServiceRoutingStyle