<gcAllowVeryLargeObjects> Element<gcAllowVeryLargeObjects> Element

Em plataformas de 64 bits, habilita matrizes com mais de 2 gigabytes (GB) de tamanho total.On 64-bit platforms, enables arrays that are greater than 2 gigabytes (GB) in total size.

<Configuração > elemento<configuration> Element
<tempo de execução > elemento<runtime> Element
<gcAllowVeryLargeObjects> Element<gcAllowVeryLargeObjects> Element

SintaxeSyntax

<gcAllowVeryLargeObjects    
   enabled="true|false" />  

Atributos e elementosAttributes and Elements

As seções a seguir descrevem atributos, elementos filho e elementos pai.The following sections describe attributes, child elements, and parent elements.

AtributosAttributes

AtributoAttribute DescriçãoDescription
enabled Atributo obrigatório.Required attribute.

Especifica se as matrizes que são maiores que 2 GB de tamanho total estão habilitadas em plataformas de 64 bits.Specifies whether arrays that are greater than 2 GB in total size are enabled on 64-bit platforms.

Atributo habilitadoenabled Attribute

ValorValue DescriçãoDescription
false Matrizes maiores que 2 GB de tamanho total não estão habilitados.Arrays greater than 2 GB in total size are not enabled. Esse é o padrão.This is the default.
true Matrizes maiores que 2 GB de tamanho total são habilitadas em plataformas de 64 bits.Arrays greater than 2 GB in total size are enabled on 64-bit platforms.

Elementos filhoChild Elements

nenhuma.None.

Elementos paiParent Elements

ElementoElement DescriçãoDescription
configuration O elemento raiz em cada arquivo de configuração usado pelos aplicativos do Common Language Runtime e .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.
runtime Contém informações sobre opções de inicialização do tempo de execução.Contains information about runtime initialization options.

ComentáriosRemarks

Usando esse elemento em seu arquivo de configuração de aplicativo permite matrizes que são maiores que 2 GB de tamanho, mas não altere outros limites de tamanho do objeto ou matriz:Using this element in your application configuration file enables arrays that are larger than 2 GB in size, but does not change other limits on object size or array size:

  • O número máximo de elementos em uma matriz é UInt32.MaxValue.The maximum number of elements in an array is UInt32.MaxValue.

  • O índice máximo em uma única dimensão é 2,147,483,591 (0x7FFFFFC7) para matrizes de bytes e matrizes de estruturas de byte único e 2,146,435,071 (0X7FEFFFFF) para outros tipos.The maximum index in any single dimension is 2,147,483,591 (0x7FFFFFC7) for byte arrays and arrays of single-byte structures, and 2,146,435,071 (0X7FEFFFFF) for other types.

  • O tamanho máximo de cadeias de caracteres e outros objetos não matriz não é alterado.The maximum size for strings and other non-array objects is unchanged.

Cuidado

Antes de habilitar esse recurso, certifique-se de que seu aplicativo não inclui o código não seguro que pressupõe que todas as matrizes são menores que 2 GB de tamanho.Before enabling this feature, ensure that your application does not include unsafe code that assumes that all arrays are smaller than 2 GB in size. Por exemplo, o código não seguro que usa matrizes como buffers pode ser suscetível a estouros de buffer se ele é gravado na suposição de que matrizes não deve exceder 2 GB.For example, unsafe code that uses arrays as buffers might be susceptible to buffer overruns if it is written on the assumption that arrays will not exceed 2 GB.

ExemploExample

O exemplo a seguir mostra como habilitar esse recurso para um aplicativo.The following example shows how to enable this feature for an application.

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

Consulte tambémSee also