<gcAllowVeryLargeObjects> elemento

  • Artigo

Em plataformas de 64 bits, permite matrizes com um tamanho total superior a 2 gigabytes (GB).

<configuração>
  <runtime>
    <gcAllowVeryLargeObjects>

Sintaxe

<gcAllowVeryLargeObjects enabled="true|false" />

Atributos

Atributo Descrição
enabled Atributo obrigatório.

Especifica se as matrizes com um tamanho total superior a 2 GB estão ativadas em plataformas de 64 bits.

atributo ativado

Valor Descrição
false As matrizes com mais de 2 GB no tamanho total não estão ativadas. Esta é a predefinição.
true As matrizes com mais de 2 GB de tamanho total estão ativadas em plataformas de 64 bits.

Elementos subordinados

Nenhum.

Elementos principais

Elemento Descrição
configuration O elemento raiz em todos os ficheiros de configuração utilizados pelo runtime de idioma comum e .NET Framework aplicações.
runtime Contém informações sobre as opções de inicialização do runtime.

Observações

A utilização deste elemento no ficheiro de configuração da aplicação permite matrizes com um tamanho superior a 2 GB, mas não altera outros limites no tamanho do objeto ou tamanho da matriz:

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

  • O tamanho máximo em qualquer dimensão individual é 2.147.483.591 (0x7FFFFFC7) para matrizes de bytes e matrizes de estruturas de byte único e 2.146.435.071 (0X7FEFFFFF) para matrizes que contenham outros tipos.

  • O tamanho máximo para cadeias de carateres e outros objetos que não são de matriz é inalterado.

Atenção

Antes de ativar esta funcionalidade, certifique-se de que a aplicação não inclui código não seguro que pressupõe que todas as matrizes têm um tamanho inferior a 2 GB. Por exemplo, o código não seguro que utiliza matrizes como memória intermédia poderá ser suscetível a ultrapassagens da memória intermédia se estiver escrito no pressuposto de que as matrizes não excederão os 2 GB.

Exemplo

O fragmento de ficheiro app.config seguinte mostra como ativar esta funcionalidade para uma aplicação .NET Framework.

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

Suportado em

.NET Framework versões 4.5 e posteriores

Ver também