<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
