ServiceBehaviorAttribute.ValidateMustUnderstand Property

Definition

Namespace:

System.ServiceModel

Assembly:

System.ServiceModel.dll

Gets or sets a value that specifies whether the system or the application enforces SOAP MustUnderstand header processing.

public:
 property bool ValidateMustUnderstand { bool get(); void set(bool value); };

public bool ValidateMustUnderstand { get; set; }

member this.ValidateMustUnderstand : bool with get, set

Public Property ValidateMustUnderstand As Boolean

Property Value

Boolean

true if the system is to perform SOAP header MustUnderstand processing; otherwise false, which indicates that the application performs this processing. The default value is true.

Remarks

Use the ValidateMustUnderstand property to turn off the enforced validation of arriving message headers. In normal execution, message headers are compared against the UnderstoodHeaders property to confirm that arriving headers are explicitly handled by the service. Set this to false to disable this checking. When set to false, the application must check for headers marked with MustUnderstand="true" and return a fault if one or more of them were not understood. This is useful when the application is supposed to accept any incoming SOAP messages (for example, when using typed or untyped messages) and perform custom header processing.