SoapDocumentServiceAttribute クラス

オプションの SoapDocumentServiceAttribute を XML Web サービスに適用することにより、そのサービス内の XML Web サービス メソッドとの間で送受信される SOAP 要求と SOAP 応答の既定の書式を設定できます。

この型のすべてのメンバの一覧については、SoapDocumentServiceAttribute メンバ を参照してください。

System.Object
   System.Attribute
      System.Web.Services.Protocols.SoapDocumentServiceAttribute

<AttributeUsage(AttributeTargets.Class)>
NotInheritable Public Class SoapDocumentServiceAttribute   Inherits Attribute
[C#]
[AttributeUsage(AttributeTargets.Class)]
public sealed class SoapDocumentServiceAttribute : Attribute
[C++]
[AttributeUsage(AttributeTargets::Class)]
public __gc __sealed class SoapDocumentServiceAttribute : public   Attribute
[JScript]
public
   AttributeUsage(AttributeTargets.Class)
class SoapDocumentServiceAttribute extends Attribute

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

SoapDocumentServiceAttribute を使用すると、XML Web サービス内の XML Web サービス メソッドについて既定の書式スタイルを設定できます。この既定値を XML Web サービス メソッドごとに変更する必要がある場合は、 SoapDocumentMethodAttribute を該当の XML Web サービス メソッドに適用します。

Web サービス記述言語 (WSDL: Web Services Description Language) では、操作を呼び出す XML Web サービス メソッドの SOAP 要求または SOAP 応答における書式として、 RPC と Document の 2 つのスタイルを定義しています。個別のメッセージ部分の詳細については、 Use プロパティと ParameterStyle プロパティを使用して指定します。 Use プロパティは、パラメータの書式として Encoded または Literal のいずれかを指定します。 ParameterStyle は、パラメータを Body 要素の下で単一のメッセージ部分にカプセル化するかどうか、または各パラメータを独立したメッセージ部分とするかどうかを指定します。

既定のメソッド レベルの書式を RPC に設定するには、 SoapRpcServiceAttribute を XML Web サービスを実装しているクラスに適用します。

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

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

使用例

 
<%@ WebService Language="VB" Class="SumService" %>

Imports System
Imports System.Web.Services
Imports System.Web.Services.Protocols
Imports System.Web.Services.Description

    <SoapDocumentService(SoapBindingUse.Literal, _
                             SoapParameterStyle.Wrapped, _
                             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;

    [SoapDocumentService(SoapBindingUse.Literal,
                         SoapParameterStyle.Wrapped,
                         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 ファミリ, .NET Compact Framework - Windows CE .NET

アセンブリ: System.Web.Services (System.Web.Services.dll 内)

参照

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