Elemento <gcAllowVeryLargeObjects>

  • Artículo

En plataformas de 64 bits, habilita matrices con un tamaño total superior a 2 gigabytes (GB).

<configuration>
  <runtime>
    <gcAllowVeryLargeObjects>

Sintaxis

<gcAllowVeryLargeObjects enabled="true|false" />

Atributos

Atributo Descripción
enabled Atributo necesario.

Especifica si las matrices con un tamaño total superior a 2 GB se habilitan en plataformas de 64 bits.

Atributo enabled

Valor Descripción
false Las matrices con un tamaño total superior a 2 GB no están habilitadas. Este es el valor predeterminado.
true Las matrices con un tamaño total superior a 2 GB se habilitan en plataformas de 64 bits.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento Descripción
configuration Elemento raíz de cada archivo de configuración usado por las aplicaciones de Common Language Runtime y .NET Framework.
runtime Contiene información sobre las opciones de inicialización del motor en tiempo de ejecución.

Comentarios

El uso de este elemento en el archivo de configuración de la aplicación permite utilizar matrices con un tamaño superior a 2 GB, pero no cambia otros límites de tamaño de objetos o matrices:

  • El número máximo de elementos de una matriz es UInt32.MaxValue.

  • El tamaño máximo de cualquier dimensión única es 2.147.483.591 (0x7FFFFFC7) para matrices de bytes y matrices de estructuras de un solo byte, y 2.146.435.071 (0X7FEFFFFF) para matrices que contienen otros tipos.

  • El tamaño máximo de las cadenas y otros objetos que no sean de matriz no varía.

Precaución

Antes de habilitar esta característica, asegúrese de que la aplicación no incluye código no seguro que supone que todas las matrices tienen un tamaño inferior a 2 GB. Por ejemplo, el código no seguro que usa matrices como búferes puede ser susceptible a saturaciones de búfer si se escribe basándose en la suposición de que las matrices no superarán los 2 GB de tamaño.

Ejemplo

El siguiente fragmento de código de archivo app.config muestra cómo habilitar esta característica para una aplicación de .NET Framework.

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

Compatible con

.NET Framework 4.5 y versiones posteriores

Consulte también