SoapUnknownHeader

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

SoapUnknownHeader クラス

SOAP ヘッダーから受信したデータのうち、受信側の XML Web サービスまたは XML Web サービス クライアントが認識できなかったデータを表します。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 SoapUnknownHeader
    Inherits SoapHeader

Visual Basic (使用法)

Dim instance As SoapUnknownHeader

C#

public sealed class SoapUnknownHeader : SoapHeader

C++

public ref class SoapUnknownHeader sealed :
 public SoapHeader

J#

public final class SoapUnknownHeader extends
 SoapHeader

JScript

public final class SoapUnknownHeader extends
 SoapHeader

解説

SOAP クライアントは、SOAP ヘッダーの形式の必須パラメータに加えられた追加データを使用して、XML Web サービスを呼び出すことがあります。ASP.NET で作成された XML Web サービスまたは XML Web サービス クライアントは、SoapHeader、SoapHeader、SoapUnknownHeader の配列、または SoapUnknownHeader の配列の MemberName プロパティを使用して SoapHeaderAttribute を XML Web サービス メソッドに適用することにより、XML Web サービスの作成時には把握していなかった任意の SOAP ヘッダーを参照できます。SoapUnknownHeader の Type を指定すると、XML Web サービスは XmlElement の形式で SOAP ヘッダーの内容を表示できます。

使用例

MyWebService XML Web サービスでは、MyWebMethod XML Web サービス メソッドの呼び出しと共に送信される MyHeader SOAP ヘッダーを受け付け、処理します。また、MyWebMethod が MyHeader SOAP ヘッダー以外のすべての SOAP ヘッダーを受信します。

Visual Basic

<%@ WebService Language="VB" Class="MyWebService"%>
Imports System.Web.Services
Imports System.Web.Services.Protocols
Imports System.Xml
Imports System

' Define a SOAP header by deriving from the SoapHeader base class.
Public Class MyHeader
    Inherits SoapHeader
    Public MyValue As String
End Class

Public Class MyWebService
    
    Public myHeader As MyHeader
    
    ' Receive all SOAP headers besides the MyHeader SOAP header.
    Public unknownHeaders() As SoapUnknownHeader
    

    'Receive any SOAP headers other than MyHeader.
    <WebMethod, _
    SoapHeader("myHeader", Direction := SoapHeaderDirection.InOut),
 _
    SoapHeader("unknownHeaders")> _
    Public Function MyWebMethod() As
 String
        Dim unknownHeaderAttributes As String
 = String.Empty
        
        ' Set myHeader.MyValue to some value.
        Dim header As SoapUnknownHeader
        For Each header In
  unknownHeaders
            ' Perform some processing on the header.
            Dim attribute As XmlAttribute
            For Each attribute In
 header.Element.Attributes
                unknownHeaderAttributes &= attribute.Name & ":"
 & _
                    attribute.Value & ";"
            Next attribute
            ' For those headers that cannot be 
            ' processed, set the DidUnderstand property to false.
            header.DidUnderstand = False
        Next header
        
        Return unknownHeaderAttributes
        
    End Function
End Class

C#

<%@ WebService Language="C#" Class="MyWebService"%>
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Xml;
using System;

// Define a SOAP header by deriving from the SoapHeader base class.

public class MyHeader : SoapHeader {
    public string MyValue;
}

public class MyWebService {

    public MyHeader myHeader;
    // Receive all SOAP headers besides the MyHeader SOAP header.
    public SoapUnknownHeader[] unknownHeaders;
 
    [WebMethod]
    [SoapHeader("myHeader", Direction=SoapHeaderDirection.InOut)]

    //Receive any SOAP headers other than MyHeader.
    [SoapHeader("unknownHeaders")]

    public string MyWebMethod() {

    string unknownHeaderAttributes = String.Empty;

        // Set myHeader.MyValue to some value.
         
       foreach (SoapUnknownHeader header in
 unknownHeaders) {
           // Perform some processing on the header.
           foreach (XmlAttribute attribute in
 header.Element.Attributes) {
              unknownHeaderAttributes = unknownHeaderAttributes + attribute.Name
 + ":" + attribute.Value + ";";            
           }
           // For those headers that cannot be 
           // processed, set the DidUnderstand property to false.
           header.DidUnderstand = false;
       }
       return unknownHeaderAttributes;
    }
}

継承階層

System.Object
   System.Web.Services.Protocols.SoapHeader
    System.Web.Services.Protocols.SoapUnknownHeader

スレッド セーフ

この型の 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

参照

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

SoapUnknownHeader コンストラクタ

SoapUnknownHeader クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New SoapUnknownHeader

C#

public SoapUnknownHeader ()

C++

public:
SoapUnknownHeader ()

J#

public SoapUnknownHeader ()

JScript

public function SoapUnknownHeader ()

プラットフォーム

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

参照

関連項目

SoapUnknownHeader クラス
SoapUnknownHeader メンバ
System.Web.Services.Protocols 名前空間

SoapUnknownHeader プロパティ

パブリック プロパティ

	名前	説明
	Actor	SOAP ヘッダーの受信者を取得または設定します。 ( SoapHeader から継承されます。)
	DidUnderstand	XML Web サービス メソッドで SOAP ヘッダーを適切に処理したかどうかを示す値を取得または設定します。 ( SoapHeader から継承されます。)
	EncodedMustUnderstand	SOAP Version 1.1 のプロトコルと通信するときに SOAP ヘッダーの mustUnderstand XML 属性の値を取得または設定します。 ( SoapHeader から継承されます。)
	EncodedMustUnderstand12	SOAP Version 1.2 のプロトコルと通信するときに SOAP ヘッダーの mustUnderstand XML 属性の値を取得または設定します。 ( SoapHeader から継承されます。)
	EncodedRelay	SOAP 1.2 ヘッダーの relay 属性を取得または設定します。 ( SoapHeader から継承されます。)
	MustUnderstand	SoapHeader を認識する必要があるかどうかを示す値を取得または設定します。 ( SoapHeader から継承されます。)
	Relay	現在のノードがヘッダーを認識しない場合に、SOAP ヘッダーを次の SOAP ノードに渡すかどうかを示す値を取得または設定します。 ( SoapHeader から継承されます。)
	Role	SOAP ヘッダーの受信者を取得または設定します。 ( SoapHeader から継承されます。)

参照

関連項目

SoapUnknownHeader クラス
System.Web.Services.Protocols 名前空間
SoapHeaderAttribute クラス
SoapHeader クラス

SoapUnknownHeader メソッド

パブリック メソッド

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

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

参照

関連項目

SoapUnknownHeader クラス
System.Web.Services.Protocols 名前空間
SoapHeaderAttribute クラス
SoapHeader クラス

SoapUnknownHeader メンバ

SOAP ヘッダーから受信したデータのうち、受信側の XML Web サービスまたは XML Web サービス クライアントが認識できなかったデータを表します。このクラスは継承できません。

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

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

	名前	説明
	SoapUnknownHeader

パブリック プロパティ

	名前	説明
	Actor	SOAP ヘッダーの受信者を取得または設定します。(SoapHeader から継承されます。)
	DidUnderstand	XML Web サービス メソッドで SOAP ヘッダーを適切に処理したかどうかを示す値を取得または設定します。(SoapHeader から継承されます。)
	EncodedMustUnderstand	SOAP Version 1.1 のプロトコルと通信するときに SOAP ヘッダーの mustUnderstand XML 属性の値を取得または設定します。(SoapHeader から継承されます。)
	EncodedMustUnderstand12	SOAP Version 1.2 のプロトコルと通信するときに SOAP ヘッダーの mustUnderstand XML 属性の値を取得または設定します。(SoapHeader から継承されます。)
	EncodedRelay	SOAP 1.2 ヘッダーの relay 属性を取得または設定します。(SoapHeader から継承されます。)
	MustUnderstand	SoapHeader を認識する必要があるかどうかを示す値を取得または設定します。(SoapHeader から継承されます。)
	Relay	現在のノードがヘッダーを認識しない場合に、SOAP ヘッダーを次の SOAP ノードに渡すかどうかを示す値を取得または設定します。(SoapHeader から継承されます。)
	Role	SOAP ヘッダーの受信者を取得または設定します。(SoapHeader から継承されます。)

パブリック メソッド

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

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

参照

関連項目

SoapUnknownHeader クラス
System.Web.Services.Protocols 名前空間
SoapHeaderAttribute クラス
SoapHeader クラス