SoapEnvelopeProcessingElement.IsStrict Property

 

Gets or sets a value that indicates whether to throw an exception if the serializer encounters unexpected elements or attributes.

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

[ConfigurationPropertyAttribute("strict", DefaultValue = false)]
public bool IsStrict { get; set; }

Property Value

Type: System.Boolean

true if the Web services serializer tries to detect unexpected elements or attributes; otherwise, false. The default is false.

Set the IsStrict property to true in order to help debug interoperation scenarios. In general, when the XmlSerializer class meets an element or attribute that it does not expect it raises an UnknownNode event and continues processing. (The same is true when the Order, Order, or Order properties are used but data is sent out of order.) Setting the IsStrict property to true instructs the Web services run time to handle that event and throw a InvalidOperationException that contains a list of the expected elements and attributes.

System_CAPS_noteNote

Because exceptions are not thrown for all unexpected elements and attributes, the IsStrict property should not be relied upon except as a debugging aid. For example, unexpected xml:lang and xml:space attributes may not cause an exception.

.NET Framework
Available since 2.0
Return to top
Show: