Elemento <gcAllowVeryLargeObjects>

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

Value 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.

Observaciones

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 una sola dimensión es 2.147.483.591 (0x7FFFFFC7) para las matrices de bytes y matrices de estructuras de un solo byte, y 2.146.435.071 (0X7FEFFFFF) para las 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 utiliza matrices como búferes podría ser susceptible a saturaciones del búfer si se escribe en la suposición de que las matrices no superarán los 2 GB.

Ejemplo

En el ejemplo siguiente se muestra cómo habilitar esta característica para una aplicación.

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

Compatible con

.NET Framework 4,5 y versiones posteriores

Vea también