XmlDictionaryReaderQuotas.MaxBytesPerRead Property

Definition

Namespace:

System.Xml

Assembly:

System.Runtime.Serialization.Xml.dll

Source:

XmlDictionaryReaderQuotas.cs

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

public:
 property int MaxBytesPerRead { int get(); void set(int value); };

public int MaxBytesPerRead { get; set; }

member this.MaxBytesPerRead : int with get, set

Public Property MaxBytesPerRead As Integer

Property Value

Int32

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

Exceptions

InvalidOperationException

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

ArgumentException

Trying to set the value to less than zero.

Remarks

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.