SoapHeader.EncodedMustUnderstand-Eigenschaft

Ruft bei der Kommunikation mit dem SOAP-Protokoll, Version 1.1, den Wert des mustUnderstand-XML-Attributs für den SOAP-Header ab oder legt diesen fest.

Namespace: System.Web.Services.Protocols
Assembly: System.Web.Services (in system.web.services.dll)

Syntax

'Declaration
Public Property EncodedMustUnderstand As String
'Usage
Dim instance As SoapHeader
Dim value As String

value = instance.EncodedMustUnderstand

instance.EncodedMustUnderstand = value

public string EncodedMustUnderstand { get; set; }

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

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

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

public function get EncodedMustUnderstand () : String

public function set EncodedMustUnderstand (value : String)

Eigenschaftenwert

Der Wert des mustUnderstand-Attributs. Der Standardwert ist "0".

Ausnahmen

Hinweise

Verwenden Sie diese Eigenschaft nicht. Verwenden Sie stattdessen die MustUnderstand-Eigenschaft.

Beispiel

' 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

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

// 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());
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SoapHeader-Klasse
SoapHeader-Member
System.Web.Services.Protocols-Namespace
MustUnderstand