XmlDictionaryReaderQuotas.MaxArrayLength Property (System.Xml)

.NET Framework Class Library

XmlDictionaryReaderQuotas..::.MaxArrayLength Property

Gets and sets the maximum allowed array length.

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

Syntax

Visual Basic (Declaration)

Public Property MaxArrayLength As Integer

Visual Basic (Usage)

Dim instance As XmlDictionaryReaderQuotas
Dim value As Integer

value = instance.MaxArrayLength

instance.MaxArrayLength = value

public int MaxArrayLength { get; set; }

Visual C++

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

JScript

public function get MaxArrayLength () : int
public function set MaxArrayLength (value : int)

Property Value

Type: System..::.Int32
The maximum allowed array length. The default is 16384.

Exceptions

Exception	Condition
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 governs the maximum array length that is created and returned by various API calls. It affects special array APIs as well as byte arrays returned from ReadContentAsBase64(). This limit does not affect the ReadContentAsBase64() override that takes an array to be populated with data.

Note that this property value applies to every step of message processing. This includes some steps that can expand the size of a message or message part. In particular, encryption can dramatically increase the size of a message. When setting this value, you must take this into account.

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

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0

Reference

XmlDictionaryReaderQuotas Class

XmlDictionaryReaderQuotas Members

System.Xml Namespace