Partilhar via

elemento <gcAllowVeryLargeObjects>

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

<configuração>
   <tempo de execução>
     <gcAllowVeryLargeObjects.>

Sintaxe

<gcAllowVeryLargeObjects enabled="true|false" />

Attributes

Attribute Description
enabled Atributo obrigatório.

Especifica se arrays com mais de 2 GB de tamanho total estão ativados em plataformas de 64 bits.

atributo habilitado

Valor Description
false Arrays com mais de 2 GB de tamanho total não estão ativados. Este é o padrão.
true Arrays com mais de 2 GB de tamanho total são ativados em plataformas de 64 bits.

Elementos filho

Nenhum.

Elementos pai

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

Observações

Usar este elemento no ficheiro de configuração da sua aplicação permite arrays com mais de 2 GB de tamanho, mas não altera outros limites no tamanho do objeto ou do array:

  • O número máximo de elementos num array é UInt32.MaxValue.

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

  • O tamanho máximo para strings e outros objetos que não sejam array mantém-se inalterado.

Atenção

Antes de ativar esta funcionalidade, certifique-se de que a sua aplicação não inclui código inseguro que assuma que todos os arrays têm menos de 2 GB de tamanho. Por exemplo, código inseguro que usa arrays como buffers pode ser suscetível a overruns de buffer se for escrito assumindo que os arrays não ultrapassarão 2 GB.

Example

O seguinte app.config excerto de ficheiro mostra como ativar esta funcionalidade numa aplicação do .NET Framework.

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

Suportado em

.NET Framework 4.5 e versões posteriores

Consulte também

  • Last updated on