<Elemento gcAllowVeryLargeObjects>

  • Articolo

Nelle piattaforme a 64 bit, abilita le matrici con dimensione totale maggiore di 2 gigabyte (GB).

<Configurazione>
  <Runtime>
    <gcAllowVeryLargeObjects>

Sintassi

<gcAllowVeryLargeObjects enabled="true|false" />

Attributi

Attributo Descrizione
enabled Attributo obbligatorio.

Specifica se le matrici con dimensione totale più grande di 2 GB sono abilitate nelle piattaforme a 64 bit.

Attributo abilitato

Valore Descrizione
false Le matrici con dimensione totale più grande di 2 GB non sono abilitate. Questo è il valore predefinito.
true Le matrici con dimensione totale più grande di 2 GB sono abilitate nelle piattaforme a 64 bit.

Elementi figlio

Nessuno.

Elementi padre

Elemento Descrizione
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.

Commenti

L'uso di questo elemento nel file di configurazione dell'applicazione consente matrici di dimensioni maggiori di 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 consentita per le stringhe e altri oggetti diversi da matrici è invariata.

Attenzione

Prima di abilitare questa funzionalità, assicurarsi che nell'applicazione non sia incluso codice di tipo unsafe in cui si presuppone che la dimensione di tutte le matrici sia inferiore a 2 GB. Ad esempio, il codice unsafe che usa matrici come buffer potrebbe essere soggetto a sovraccarichi del buffer se viene scritto sul presupposto che le matrici non superino 2 GB.

Esempio

Il frammento di file diapp.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

Vedi anche