XmlDictionaryReaderQuotas.MaxBytesPerRead Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets and sets the maximum allowed bytes returned for each read.

Namespace:   System.Xml
Assembly:  System.Runtime.Serialization (in System.Runtime.Serialization.dll)

member MaxBytesPerRead : int with get, set

Property Value

Type: System.Int32

The maximum allowed bytes returned for each read. The default is 4096.

Exception Condition

Trying to set the value, but quota values are read-only for this instance.


Trying to set the value to less than zero.

This quota limits the number of bytes that can be consumed by the reader during a single call to Read().

This quota is an approximation, because transformations in the encoding layer happen before this quota is applied. This quota is closely tied to the number of bytes received on the wire at the transport level, but its purpose is to control the quantity of data we receive for each read. In practice, it is used to limit the size of start tags. Because the entire start tag must be buffered to be processed (attributes uniqueness must be verified), the size must be limited to mitigate DOS attacks.

Instances created with the public constructor have properties that can be set.

Universal Windows Platform
Available since 8
.NET Framework
Available since 3.0
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top