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.

C#

public bool ValidateMustUnderstand { get; set; }

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.

Applies to