SoapHeader::EncodedMustUnderstand Property

 

Gets or sets the value of the mustUnderstand XML attribute for the SOAP header when communicating with SOAP protocol version 1.1.

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

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

Property Value

Type: System::String^

The value of the mustUnderstand attribute. The default is "0".

Exception Condition
ArgumentException

The property is set to a value other than: "0", "1", "true", or "false".

Do not use this property. Instead use the MustUnderstand property.

// MyHeader class is derived from the SoapHeader class.
MyHeader ^ customHeader = gcnew MyHeader;
customHeader->MyValue = "Header value for MyValue";

// Set the EncodedMustUnderstand property to true.
customHeader->EncodedMustUnderstand = "1";
WebService_SoapHeader_EncodedMustUnderstand ^ myWebService = gcnew WebService_SoapHeader_EncodedMustUnderstand;
myWebService->myHeader1 = customHeader;
String^ results = myWebService->MyWebMethod1();
Console::WriteLine( results );
try
{
   results = myWebService->MyWebMethod2();
}
catch ( Exception^ myException ) 
{
   Console::WriteLine( "Exception raised in MyWebMethod2." );
   Console::WriteLine( "Message: {0}", myException->Message );
}

.NET Framework
Available since 1.1
Return to top
Show: