SoapHeader.EncodedMustUnderstand プロパティ

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

SoapHeader.EncodedMustUnderstand プロパティ

SOAP Version 1.1 のプロトコルと通信するときに SOAP ヘッダーの mustUnderstand XML 属性の値を取得または設定します。

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

Visual Basic (宣言)

Public Property EncodedMustUnderstand As
 String

Visual Basic (使用法)

Dim instance As SoapHeader
Dim value As String

value = instance.EncodedMustUnderstand

instance.EncodedMustUnderstand = value

C#

public string EncodedMustUnderstand { get;
 set; }

C++

public:
property String^ EncodedMustUnderstand {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_EncodedMustUnderstand ()

/** @property */
public void set_EncodedMustUnderstand (String
 value)

JScript

public function get EncodedMustUnderstand
 () : String

public function set EncodedMustUnderstand
 (value : String)

プロパティ値
mustUnderstand 属性の値。既定値は "0" です。

例外

例外の種類	条件
ArgumentException	このプロパティは "0"、"1"、"true"、または "false" 以外の値に設定します。

解説

このプロパティは使用しないでください。代わりに、MustUnderstand プロパティを使用してください。

使用例

Visual Basic

' MyHeader class inherits from the SoapHeader class.
Dim customHeader As New
 MyHeader()
customHeader.MyValue = "Header value for MyValue"

' Set the EncodedMustUnderstand property to true.
customHeader.EncodedMustUnderstand = "1"

Dim myWebService As New
 WebService_SoapHeader_EncodedMustUnderstand()
myWebService.MyHeaderValue = customHeader
Dim results As String =
 myWebService.MyWebMethod1()
Console.WriteLine(results)
Try
    results = myWebService.MyWebMethod2()
Catch myException As Exception
    Console.WriteLine("Exception raised in MyWebMethod2.")
    Console.WriteLine("Message: " & myException.Message)
End Try

C#

// MyHeader class is derived from the SoapHeader class.
MyHeader customHeader = new MyHeader();
customHeader.MyValue = "Header value for MyValue";

// Set the EncodedMustUnderstand property to true.
customHeader.EncodedMustUnderstand = "1";

WebService_SoapHeader_EncodedMustUnderstand myWebService = 
    new WebService_SoapHeader_EncodedMustUnderstand();
myWebService.MyHeaderValue = customHeader;
string results = myWebService.MyWebMethod1();
Console.WriteLine(results);
try
{
    results = myWebService.MyWebMethod2();
}
catch(Exception myException)
{
    Console.WriteLine("Exception raised in MyWebMethod2.");
    Console.WriteLine("Message: " + myException.Message);
}

J#

// MyHeader class is derived from the SoapHeader class.
MyHeader customHeader = new MyHeader();
customHeader.MyValue = "Header value for MyValue";
// Set the EncodedMustUnderstand property to true.
customHeader.set_EncodedMustUnderstand("1");

WebService_SoapHeader_EncodedMustUnderstand myWebService 
    = new WebService_SoapHeader_EncodedMustUnderstand();

myWebService.myHeader1 = customHeader;
String results = myWebService.MyWebMethod1();
Console.WriteLine(results);
try {
    results = myWebService.MyWebMethod2();
}
catch (System.Exception myException) {
    Console.WriteLine("Exception raised in MyWebMethod2.");
    Console.WriteLine("Message: " + myException.get_Message());
}

プラットフォーム

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

参照

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