Condividi tramite


elemento <gcAllowVeryLargeObjects>

Nelle piattaforme a 64 bit, abilita matrici con dimensioni totali superiori a 2 gigabyte (GB).

<configurazione>
   <Runtime>
     <gcAllowVeryLargeObjects>

Sintassi

<gcAllowVeryLargeObjects enabled="true|false" />

Attributes

Attribute Description
enabled Attributo obbligatorio.

Specifica se le matrici con dimensioni totali maggiori di 2 GB sono abilitate nelle piattaforme a 64 bit.

attributo abilitato

Value Description
false Le matrici superiori a 2 GB di dimensioni totali non sono abilitate. Si tratta dell'impostazione predefinita.
true Le matrici superiori a 2 GB in dimensioni totali sono abilitate su piattaforme a 64 bit.

Elementi figlio

Nessuno.

Elementi padre

Elemento Description
configuration Elemento radice in ciascun file di configurazione usato in Common Language Runtime e nelle applicazioni .NET Framework.
runtime Contiene informazioni sulle opzioni di inizializzazione in fase di esecuzione.

Osservazioni:

L'uso di questo elemento nel file di configurazione dell'applicazione consente matrici di dimensioni superiori a 2 GB, ma non modifica altri limiti per le dimensioni dell'oggetto o della matrice:

  • Il numero massimo di elementi in una matrice è UInt32.MaxValue.

  • La dimensione massima in qualsiasi dimensione singola è 2.147.483.591 (0x7FFFFFC7) per matrici di byte e matrici di strutture a byte singolo e 2.146.435.071 (0X7FEFFFFF) per matrici contenenti altri tipi.

  • La dimensione massima per le stringhe e altri oggetti non matrice rimane invariata.

Attenzione

Prima di abilitare questa funzionalità, assicurarsi che l'applicazione non includa codice non sicuro che presuppone che tutte le matrici siano di dimensioni inferiori a 2 GB. Ad esempio, il codice non sicuro che usa matrici come buffer potrebbe essere soggetto a sovraccarichi del buffer se viene scritto sul presupposto che le matrici non superino i 2 GB.

Example

Il frammento di file app.config seguente illustra come abilitare questa funzionalità per un'applicazione .NET Framework.

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

Supportato in

.NET Framework 4.5 e versioni successive

Vedere anche