<gcAllowVeryLargeObjects> Element

On 64-bit platforms, enables arrays that are greater than 2 gigabytes (GB) in total size.

<configuration> Element
<runtime> Element
<gcAllowVeryLargeObjects> Element

Syntax

<gcAllowVeryLargeObjects    
   enabled="true|false" />  

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute Description
enabled Required attribute.

Specifies whether arrays that are greater than 2 GB in total size are enabled on 64-bit platforms.

enabled Attribute

Value Description
false Arrays greater than 2 GB in total size are not enabled. This is the default.
true Arrays greater than 2 GB in total size are enabled on 64-bit platforms.

Child Elements

None.

Parent Elements

Element Description
configuration The root element in every configuration file used by the common language runtime and .NET Framework applications.
runtime Contains information about runtime initialization options.

Remarks

Using this element in your application configuration file enables arrays that are larger than 2 GB in size, but does not change other limits on object size or array size:

  • The maximum number of elements in an array is System.UInt32.MaxValue.

  • The maximum index in any single dimension is 2,147,483,591 (0x7FFFFFC7) for byte arrays and arrays of single-byte structures, and 2,146,435,071 (0X7FEFFFFF) for other types.

  • The maximum size for strings and other non-array objects is unchanged.

Caution

Before enabling this feature, ensure that your application does not include unsafe code that assumes that all arrays are smaller than 2 GB in size. For example, unsafe code that uses arrays as buffers might be susceptible to buffer overruns if it is written on the assumption that arrays will not exceed 2 GB.

Example

The following example shows how to enable this feature for an application.

<configuration>  
  <runtime>  
    <gcAllowVeryLargeObjects enabled="true" />  
  </runtime>  
</configuration>  

See Also

Runtime Settings Schema
Configuration File Schema