SoapHeaderDirection 列挙体

SoapHeader の受信者が XML Web サービス、XML Web サービス クライアント、またはその両方のいずれであるかを指定します。

この列挙体には、メンバ値をビットごとに演算するための FlagsAttribute 属性が含まれています。

<Flags>
<Serializable>
Public Enum SoapHeaderDirection
[C#]
[Flags]
[Serializable]
public enum SoapHeaderDirection
[C++]
[Flags]
[Serializable]
__value public enum SoapHeaderDirection
[JScript]
public
   Flags
 Serializable
enum SoapHeaderDirection

解説

SoapHeaderAttribute は、XML Web サービス メソッドまたは XML Web サービスのプロキシ クラスのメソッドに適用できます。どちらの場合も、受信者は SoapHeaderAttribute の Direction プロパティによって指定されます。実行時に例外がスローされたとき、XML Web サービス メソッドが SOAP ヘッダーを返すよう設定するには、 SoapHeaderAttribute をメソッドに適用し、 Direction プロパティを Fault に設定します。

.NET Framework の Version 1.0 は Fault 値をサポートしていません。

メンバ

メンバ名	説明	値
Fault	XML Web サービス メソッドによって例外がスローされたときに SoapHeader を XML Web サービス クライアントに送信するように指定します。	4
In .NET Compact Framework でもサポート。	SoapHeader を XML Web サービスに送信するように指定します。	1
InOut .NET Compact Framework でもサポート。	SoapHeader を XML Web サービスと XML Web サービス クライアントの両方に送信するように指定します。	3
Out .NET Compact Framework でもサポート。	SoapHeader を XML Web サービス クライアントに送信するように指定します。	2

使用例

[Visual Basic, C#, C++] XML Web サービス メソッドの実行時にスローされる例外にかかわらず、 myHeader SoapHeader が XML Web サービス クライアントから XML Web サービスに送信されてから、再び XML Web サービス クライアントに返されるように指定する XML Web サービス メソッドを次に示します。

 
Public Class MyHeader
    Inherits SoapHeader
    Public MyValue As String
End Class

Public Class MyWebService
    
    Public myHeader As MyHeader    
    
    <WebMethod, _
    SoapHeader("myHeader", _
                Direction := SoapHeaderDirection.InOut Or SoapHeaderDirection.Fault)> _
    Public Sub MySoapHeaderReceivingMethod()

        ' Set myHeader.MyValue to some value.
        
    End Sub
    
End Class


[C#] 
public class MyHeader : SoapHeader {
    public string MyValue;
}

public class MyWebService {

    public MyHeader myHeader;

    [WebMethod]
    [SoapHeader("myHeader", 
                Direction=SoapHeaderDirection.InOut | SoapHeaderDirection.Fault)]
    public void MySoapHeaderReceivingMethod() {

        // Set myHeader.MyValue to some value.

    }
}
   

[C++] 
public __gc class MyHeader : public SoapHeader {
public:
    String* MyValue;
};

public __gc class MyWebService {

public:
    MyHeader* myHeader;

    [WebMethod]
    [SoapHeader(S"myHeader", 
                Direction=SoapHeaderDirection::InOut | SoapHeaderDirection::Fault)]
    void MySoapHeaderReceivingMethod() {

        // Set myHeader->MyValue to some value.

    }
};
   

[JScript] JScript のサンプルはありません。Visual Basic、C#、および 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 内)

参照

System.Web.Services.Protocols 名前空間 | SoapHeaderAttribute | SoapHeader