方法 : 不明な SOAP ヘッダーを処理する

[アーティクル]
02/24/2011

このトピックの対象は、レガシテクノロジに特定されています。XML Web サービスと XML Web サービスクライアントは以下を使用して作成してください。 Windows Communication Foundation.

Web サービスが予期していたが明示的には定義されていない可能性のある SOAP ヘッダーを持つ SOAP 要求が、Web サービスクライアントから Web サービスメソッドに送信されることがあります。この場合、SOAP ヘッダーのセマンティクスが認識および処理されるかどうかを確認することが重要です。SOAP 仕様では、SOAP ヘッダーの mustUnderstand 属性が true に設定されている場合に例外がスローされることが規定されているためです。クライアントによって要求される SOAP ヘッダーの処理の詳細については、「方法 : XML Web サービスクライアントによって要求される SOAP ヘッダーを処理する」を参照してください。

Web サービスクライアントからの不明な SOAP ヘッダーを処理するには

複数の不明な SOAP ヘッダーを処理するために、SoapUnknownHeader または SoapHeader の型、あるいはどちらかの配列を使用して、Web サービスを実装するクラスにメンバー変数を追加します。

型を SoapUnknownHeader の配列または単一インスタンスとして宣言すると、SoapUnknownHeader には Element プロパティがあるということが利点です。Element プロパティは、XmlElement 型であり、SOAP 要求または SOAP 応答の Header 要素の XML ドキュメントを表します。したがって、Web サービスメソッドは、Element プロパティを調べることで、SOAP ヘッダーの名前と、SOAP ヘッダーによって渡されたデータを確認できます。
```
public class MyWebService {
    public SoapUnknownHeader[] unknownHeaders;
```
```
Public Class MyWebService
    Public unknownHeaders() As SoapUnknownHeader
```

不明な各 SOAP ヘッダーを処理する各 Web サービスメソッドに SoapHeader 属性を適用します。


    [WebMethod]
    [SoapHeader("unknownHeaders")]
    public string MyWebMethod()

    <WebMethod, _
     SoapHeader("unknownHeaders") > _
    Public Function MyWebMethod() As String

不明な SOAP ヘッダーを処理できるようにするかどうかを決定するコードを追加します。

メンバー変数の型が SoapUnknownHeader である場合、Web サービスメソッドは、Element プロパティを調べることで、SOAP ヘッダーの名前と SOAP ヘッダーによって渡されたデータを確認できます。Element プロパティの Name プロパティによって、SOAP ヘッダーの名前が識別されます。
```
       foreach (SoapUnknownHeader header in unknownHeaders) 
       {
         // Check to see if this a known header.
         if (header.Element.Name == "MyKnownHeader")
```
```
       Dim header As SoapUnknownHeader       
       For Each header In unknownHeaders
         ' Check to see if this is a known header.
         If (header.Element.Name = "MyKnownHeader") Then
```

特定の SOAP ヘッダーの処理方法がわかっている場合は、不明な SOAP ヘッダーを表すメンバー変数の DidUnderstand プロパティを true に設定します。

Web サービスメソッドが不明な SOAP ヘッダーを処理する場合に、DidUnderstand プロパティを true に設定しなかったときは、SoapHeaderException がスローされます。詳細については、「方法 : XML Web サービスクライアントによって要求される SOAP ヘッダーを処理する」を参照してください。

         // Check to see if this is a known header.
         if (header.Element.Name == "MyKnownHeader")
               header.DidUnderstand = true;
         else
             // For those headers that cannot be 
             // processed, set DidUnderstand to false.
             header.DidUnderstand = false;
         }

         ' Check to see if this a known header.
         If (header.Element.Name = "MyKnownHeader") Then
               header.DidUnderstand = True
         Else
             ' For those headers that cannot be 
             ' processed, set DidUnderstand to false.
             header.DidUnderstand = False
         End If

注 :
ASP.NET を使用して作成した Web サービスでは、Web サービスメソッドとの通信で DidUnderstand プロパティが使用されます。このプロパティは SOAP 仕様の一部ではなく、その値は SOAP 要求または SOAP 応答には含まれません。

注 :
Web サービスクライアントが Web サービス記述言語ツール (Wsdl.exe) を使用してプロキシクラスを構築し、Web サービスが SOAP ヘッダーを表すメンバー変数を SoapUnknownHeader 型を使用して定義している場合、その SOAP ヘッダーへの参照はプロキシクラスには追加されません。Web サービスクライアントがその SOAP ヘッダーを SOAP 要求に追加する場合は、メンバー変数を追加し、適切な Web サービスメソッドを呼び出すメソッドに SoapHeader 属性を適用して、プロキシクラスを変更する必要があります。

Web サービスクライアントが Web サービス記述言語ツール (Wsdl.exe) を使用してプロキシクラスを構築し、Web サービスが SOAP ヘッダーを表すメンバー変数を SoapUnknownHeader 型を使用して定義している場合、その SOAP ヘッダーへの参照はプロキシクラスには追加されません。Web サービスクライアントがその SOAP ヘッダーを SOAP 要求に追加する場合は、メンバー変数を追加し、適切な Web サービスメソッドを呼び出すメソッドに SoapHeader 属性を適用して、プロキシクラスを変更する必要があります。

参照

次の方法で共有

方法 : 不明な SOAP ヘッダーを処理する

Web サービス クライアントからの不明な SOAP ヘッダーを処理するには

参照

リファレンス

概念

その他のリソース

その他のリソース

Web サービスクライアントからの不明な SOAP ヘッダーを処理するには