SoapDocumentServiceAttributeとは何？わかりやすく解説 Weblio辞書

オプションの SoapDocumentServiceAttribute を 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
 SoapDocumentServiceAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As SoapDocumentServiceAttribute

C#

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

C++

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

J#

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

JScript

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

解説

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 サービスを実装しているクラスに適用できます。

使用例

Visual Basic

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

継承階層

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

スレッドセーフ

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

プラットフォーム

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

参照

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

すべてのプロパティを既定値に設定し、SoapDocumentServiceAttribute クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New SoapDocumentServiceAttribute

C#

public SoapDocumentServiceAttribute ()

C++

public:
SoapDocumentServiceAttribute ()

J#

public SoapDocumentServiceAttribute ()

JScript

public function SoapDocumentServiceAttribute
 ()

使用例

Visual Basic

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

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

    <SoapDocumentService(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(RoutingStyle=SoapServiceRoutingStyle.SoapAction)]
    public class SumService : System.Web.Services.WebService
    {
        [WebMethod]
        public int Add(int
 a, int b)
        {
            return a + b;
        }
    }

プラットフォーム

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

参照

関連項目
SoapDocumentServiceAttribute クラス
SoapDocumentServiceAttribute メンバ
System.Web.Services.Protocols 名前空間

パラメータの書式を指定し、SOAP メッセージ内の Body 要素の下で単一の XML 要素内にパラメータをカプセル化するかどうかを指定する SoapDocumentServiceAttribute クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    use As SoapBindingUse, _
    paramStyle As SoapParameterStyle _
)

Visual Basic (使用法)

Dim use As SoapBindingUse
Dim paramStyle As SoapParameterStyle

Dim instance As New SoapDocumentServiceAttribute(use,
 paramStyle)

C#

public SoapDocumentServiceAttribute (
    SoapBindingUse use,
    SoapParameterStyle paramStyle
)

C++

public:
SoapDocumentServiceAttribute (
    SoapBindingUse use, 
    SoapParameterStyle paramStyle
)

J#

public SoapDocumentServiceAttribute (
    SoapBindingUse use, 
    SoapParameterStyle paramStyle
)

JScript

public function SoapDocumentServiceAttribute
 (
    use : SoapBindingUse, 
    paramStyle : SoapParameterStyle
)

パラメータ

use: パラメータの書式スタイル。Use プロパティを設定します。

paramStyle: XML Web サービス内の XML Web サービスメソッドとの間で送受信される SOAP メッセージで、Body 要素の下にある単一の XML 要素内にパラメータをカプセル化するかどうかを設定します。ParameterStyle プロパティを設定します。

使用例

Visual Basic

<%@ 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)> _
    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)]
    public class SumService : System.Web.Services.WebService
    {
        [WebMethod]
        public int Add(int
 a, int b)
        {
            return a + b;
        }
    }

プラットフォーム

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

参照

関連項目
SoapDocumentServiceAttribute クラス
SoapDocumentServiceAttribute メンバ
System.Web.Services.Protocols 名前空間

パラメータの書式を指定し、SoapDocumentServiceAttribute クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    use As SoapBindingUse _
)

Visual Basic (使用法)

Dim use As SoapBindingUse

Dim instance As New SoapDocumentServiceAttribute(use)

C#

public SoapDocumentServiceAttribute (
    SoapBindingUse use
)

C++

public:
SoapDocumentServiceAttribute (
    SoapBindingUse use
)

J#

public SoapDocumentServiceAttribute (
    SoapBindingUse use
)

JScript

public function SoapDocumentServiceAttribute
 (
    use : SoapBindingUse
)

パラメータ

use: XML Web サービスのパラメータの書式スタイル。Use プロパティを設定します。

使用例

Visual Basic

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

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

    <SoapDocumentService(SoapBindingUse.Encoded)> _
    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.Encoded)]
    public class SumService : System.Web.Services.WebService
    {
        [WebMethod]
        public int Add(int
 a, int b)
        {
            return a + b;
        }
    }

プラットフォーム

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

参照

関連項目
SoapDocumentServiceAttribute クラス
SoapDocumentServiceAttribute メンバ
System.Web.Services.Protocols 名前空間

SoapDocumentServiceAttribute クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
SoapDocumentServiceAttribute ()	すべてのプロパティを既定値に設定し、SoapDocumentServiceAttribute クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
SoapDocumentServiceAttribute (SoapBindingUse)	パラメータの書式を指定し、SoapDocumentServiceAttribute クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
SoapDocumentServiceAttribute (SoapBindingUse, SoapParameterStyle)	パラメータの書式を指定し、SOAP メッセージ内の Body 要素の下で単一の XML 要素内にパラメータをカプセル化するかどうかを指定する SoapDocumentServiceAttribute クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。

参照

	名前	説明
	TypeId	派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。 ( Attribute から継承されます。)
	Use	XML Web サービスの既定のパラメータ書式を取得または設定します。

その他の技術情報

SOAP メッセージ形式のカスタマイズ

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。 ( Attribute から継承されます。)
	GetCustomAttribute	オーバーロードされます。アセンブリ、モジュール、型のメンバ、またはメソッドパラメータに適用された指定した型のカスタム属性を取得します。 ( Attribute から継承されます。)
	GetCustomAttributes	オーバーロードされます。アセンブリ、モジュール、型のメンバ、またはメソッドパラメータに適用されたカスタム属性の配列を取得します。 ( Attribute から継承されます。)
	GetHashCode	このインスタンスのハッシュコードを返します。 ( Attribute から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IsDefaultAttribute	派生クラス内でオーバーライドされたときに、このインスタンスの値が派生クラスの既定値かどうかを示します。 ( Attribute から継承されます。)
	IsDefined	オーバーロードされます。指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッドパラメータに適用されているかどうかを判断します。 ( Attribute から継承されます。)
	Match	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 ( Attribute から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

その他の技術情報

SOAP メッセージ形式のカスタマイズ

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

SoapDocumentServiceAttribute データ型で公開されるメンバを以下の表に示します。

パブリックコンストラクタ

	名前	説明
	SoapDocumentServiceAttribute	オーバーロードされます。 SoapDocumentServiceAttribute クラスの新しいインスタンスを初期化します。

パブリックプロパティ

	名前	説明
	TypeId	派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。(Attribute から継承されます。)
	Use	XML Web サービスの既定のパラメータ書式を取得または設定します。

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。 ( Attribute から継承されます。)
	GetCustomAttribute	オーバーロードされます。アセンブリ、モジュール、型のメンバ、またはメソッドパラメータに適用された指定した型のカスタム属性を取得します。 (Attribute から継承されます。)
	GetCustomAttributes	オーバーロードされます。アセンブリ、モジュール、型のメンバ、またはメソッドパラメータに適用されたカスタム属性の配列を取得します。 (Attribute から継承されます。)
	GetHashCode	このインスタンスのハッシュコードを返します。 (Attribute から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IsDefaultAttribute	派生クラス内でオーバーライドされたときに、このインスタンスの値が派生クラスの既定値かどうかを示します。 (Attribute から継承されます。)
	IsDefined	オーバーロードされます。指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッドパラメータに適用されているかどうかを判断します。 (Attribute から継承されます。)
	Match	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (Attribute から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

その他の技術情報

SOAP メッセージ形式のカスタマイズ

SoapDocumentServiceAttributeとは？わかりやすく解説

SoapDocumentServiceAttribute クラス

SoapDocumentServiceAttribute コンストラクタ ()

SoapDocumentServiceAttribute コンストラクタ (SoapBindingUse, SoapParameterStyle)

SoapDocumentServiceAttribute コンストラクタ (SoapBindingUse)

SoapDocumentServiceAttribute コンストラクタ

関連項目

SoapDocumentServiceAttribute プロパティ

関連項目

その他の技術情報

SoapDocumentServiceAttribute メソッド

関連項目

その他の技術情報

SoapDocumentServiceAttribute メンバ

関連項目

その他の技術情報

「SoapDocumentServiceAttribute」の関連用語


	© 2025 Microsoft.All rights reserved.

SoapDocumentServiceAttributeとは？ わかりやすく解説

SoapDocumentServiceAttribute クラス

SoapDocumentServiceAttribute コンストラクタ ()

SoapDocumentServiceAttribute コンストラクタ (SoapBindingUse, SoapParameterStyle)

SoapDocumentServiceAttribute コンストラクタ (SoapBindingUse)

SoapDocumentServiceAttribute コンストラクタ

関連項目

SoapDocumentServiceAttribute プロパティ

関連項目

その他の技術情報

SoapDocumentServiceAttribute メソッド

関連項目

その他の技術情報

SoapDocumentServiceAttribute メンバ

関連項目

その他の技術情報

急上昇のことば

「SoapDocumentServiceAttribute」の関連用語

SoapDocumentServiceAttributeとは？わかりやすく解説