XmlDictionaryReaderQuotas.MaxStringContentLength Property

Definition

Namespace:

System.Xml

Assembly:

System.Runtime.Serialization.Xml.dll

Source:

XmlDictionaryReaderQuotas.cs

Gets or sets the maximum string length returned by the reader.

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

public int MaxStringContentLength { get; set; }

member this.MaxStringContentLength : int with get, set

Public Property MaxStringContentLength As Integer

Property Value

Int32

The maximum string length returned by the reader. The default is 8192.

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 length of strings that are created and returned by various APIs. When calling Read() and checking the Value property, the reader chunks string values into manageable pieces (when in streaming mode). However, calling ReadContentAsString() concatenates all these pieces and return one large string. In the binary format, if the value of an element node is a sequence of dictionary string IDs then the values of those strings are concatenated. This can be an extremely large expansion and is mitigated by this limit.