Compartilhar via

<gcAllowVeryLargeObjects> elemento

Em plataformas de 64 bits, habilita matrizes maiores que 2 GB (gigabytes) em tamanho total.

<configuração>
   <Runtime>
     <gcAllowVeryLargeObjects>

Sintaxe

<gcAllowVeryLargeObjects enabled="true|false" />

Attributes

Attribute Description
enabled Atributo necessário.

Especifica se matrizes maiores que 2 GB no tamanho total estão habilitadas em plataformas de 64 bits.

atributo habilitado

Value Description
false Matrizes maiores que 2 GB no tamanho total não estão habilitadas. Esse é o padrão.
true Matrizes maiores que 2 GB no tamanho total estão habilitadas em plataformas de 64 bits.

Elementos filho

Nenhum.

Elementos pai

Elemento Description
configuration O elemento raiz em cada arquivo de configuração usado pelos aplicativos do Common Language Runtime e .NET Framework.
runtime Contém informações sobre opções de inicialização do runtime.

Observações

Usar esse elemento no arquivo de configuração do aplicativo permite matrizes maiores que 2 GB de tamanho, mas não altera outros limites no tamanho do objeto ou no tamanho da matriz:

  • O número máximo de elementos em uma matriz é UInt32.MaxValue.

  • O tamanho máximo em qualquer dimensão única é 2.147.483.591 (0x7FFFFFC7) para matrizes de bytes e matrizes de estruturas de bytes únicos e 2.146.435.071 (0X7FEFFFFF) para matrizes que contêm outros tipos.

  • O tamanho máximo para cadeias de caracteres e outros objetos que não são de matriz não são alterados.

Cuidado

Antes de habilitar esse recurso, verifique se o aplicativo não inclui código não seguro que pressupõe que todas as matrizes sejam menores que 2 GB de tamanho. Por exemplo, o código não seguro que usa matrizes como buffers poderá ser suscetível a sobrecargas de buffer se for gravado na suposição de que as matrizes não excederão 2 GB.

Example

O snippet de arquivoapp.configa seguir mostra como habilitar esse recurso para um aplicativo .NET Framework.

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

Compatível em

.NET Framework 4.5 e versões posteriores

Consulte também

  • Last updated on