Share via


SoapEnvelopeProcessingInfo Class [IIS 7 and higher]

Configures a time-out that helps mitigate denial of service attacks.

Syntax

class SoapEnvelopeProcessingInfo : EmbeddedObject

Methods

This class contains no methods.

Properties

The following table lists the properties exposed by the SoapEnvelopeProcessingInfo class.

Name

Description

ReadTimeout

A read/write sint32 value that specifies the time, in milliseconds, that the XML Web service waits before it terminates requests to the System.Xml.XmlReader.Read and System.Xml.XmlReader.MoveToContent methods. The default is 2147483647.

The time-out period is checked on every call to Read and MoveToContent and is used to mitigate denial of service attacks.

Strict

A read/write boolean value. true if the Web service serializer throws an exception if it encounters unexpected elements or attributes; otherwise, false. The default is false.

Subclasses

This class contains no subclasses.

Remarks

Instances of this class are exposed as members of the SoapEnvelopeProcessing property on the WebServicesSection class.

Set the Strict property to true in order to help debug interoperation scenarios. In general, when the System.Xml.Serialization.XmlSerializer class encounters an element or attribute that it does not expect, it raises an UnknownNode event and continues processing. Setting the Strict property to true instructs the Web service run-time functions to handle that event and throw an InvalidOperationException that contains a list of the expected elements and attributes.

Note

Because exceptions are not thrown for all unexpected elements and attributes, you should not rely on the Strict property except as a debugging aid. For example, unexpected xml:lang and xml:space attributes may not cause an exception.

Inheritance Hierarchy

EmbeddedObject

   SoapEnvelopeProcessingInfo

Requirements

Type

Description

Client

Requires IIS 7 on Windows Vista.

Server

Requires IIS 7 on Windows Server 2008.

Product

IIS 7

MOF file

WebAdministration.mof

See Also

Reference

EmbeddedObject Class [IIS 7 and higher]

WebServicesSection Class [IIS 7 and higher]

Other Resources

InvalidOperationException

System.Web.Services.Configuration.SoapEnvelopeProcessingElement Properties

System.Xml.XmlReader.MoveToContent Method

System.Xml.XmlReader.Read Method

System.Xml.Serialization.XmlSerializer Class

System.Xml.Serialization.XmlSerializer.UnknownNode Event