Compartilhar via


<gcAllowVeryLargeObjects> element

Em plataformas de 64 bits, habilita matrizes com mais de 2 gigabytes (GB) de tamanho total.

<configuration>
  <runtime>
    <gcAllowVeryLargeObjects>

Syntax

<gcAllowVeryLargeObjects enabled="true|false" />  

Atributos

Atributo Descrição
enabled Atributo obrigatório.

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

Atributo enabled

Valor Descrição
false As matrizes maiores que 2 GB no tamanho total não estão habilitadas. Esse é o padrão.
true As matrizes maiores que 2 GB no tamanho total estão habilitadas em plataformas de 64 bits.

Elementos filho

Nenhum.

Elementos pai

Elemento Descrição
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.

Comentários

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

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

  • O tamanho máximo em qualquer dimensão única é de 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 um código não seguro que pressupõe que todas as matrizes sejam menores que 2 GB. Por exemplo, um código não seguro que usa matrizes como buffers poderá estar suscetível a sobrecargas de buffer se foi escrito com a suposição de que as matrizes não excederão 2 GB.

Exemplo

O snippet de arquivo app.config a seguir mostra como habilitar esse recurso para um aplicativo .NET Framework.

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

Com suporte em

.NET Framework 4.5 e versões posteriores

Confira também