CallbackBehaviorAttribute::ValidateMustUnderstand Property

 

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

Namespace:   System.ServiceModel
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

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

Property Value

Type: System::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.

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 callback object runtime. 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 callback is supposed to accept any incoming SOAP messages (for example, when using typed or untyped messages) and perform custom header processing.

The following code example shows a CallbackBehaviorAttribute on a callback object that uses the SynchronizationContext object to determine which thread to marshal to, the ValidateMustUnderstand property to enforce message validation, and the IncludeExceptionDetailInFaults property to return exceptions as FaultException objects to the service for debugging purposes.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 3.0
Return to top
Show: