SoapUnknownHeader.Element プロパティ

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

SoapUnknownHeader.Element プロパティ

SOAP 要求または SOAP 応答の XML ヘッダー要素を取得または設定します。

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

Visual Basic (宣言)

Public Property Element As
 XmlElement

Visual Basic (使用法)

Dim instance As SoapUnknownHeader
Dim value As XmlElement

value = instance.Element

instance.Element = value

C#

public XmlElement Element { get; set;
 }

C++

public:
property XmlElement^ Element {
    XmlElement^ get ();
    void set (XmlElement^ value);
}

J#

/** @property */
public XmlElement get_Element ()

/** @property */
public void set_Element (XmlElement value)

JScript

public function get Element
 () : XmlElement

public function set Element
 (value : XmlElement)

プロパティ値
SOAP ヘッダーの生の XML を表す XmlElement。

解説

XML Web サービス メソッドが、XML Web サービスの書き込み時には不明だった SOAP ヘッダーを処理する場合は、その SOAP ヘッダーの生の XML を表す XmlElement クラスを処理できます。

使用例

認識している MyHeader SOAP ヘッダー以外のヘッダーを含めたすべての SOAP ヘッダーを受け取る MyWebService XML Web サービスを次に示します。MyWebMethod XML Web サービス メソッドは、文字列として渡された最後の不明な SOAP ヘッダーの XML 属性をクライアントに返します。

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

プラットフォーム

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 名前空間
XmlElement
SoapHeaderAttribute クラス