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 string EncodedMustUnderstand { get; set; }

Property Value

Type: System.String

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

Exception Condition

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 = 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();
    results = myWebService.MyWebMethod2();
catch(Exception myException)
    Console.WriteLine("Exception raised in MyWebMethod2.");
    Console.WriteLine("Message: " + myException.Message);

.NET Framework
Available since 1.1
Return to top