Elemento <gcAllowVeryLargeObjects>

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

<configuration>
  <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 enabled

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

Nessuna.

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'utilizzo di questo elemento nel file di configurazione dell'applicazione abilita le matrici con dimensione maggiori di 2 GB, ma non consente di modificare gli altri limiti relativi alla dimensione dell'oggetto o della matrice:

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

  • La dimensione massima in ogni singola dimensione è 2.147.483.591 (0x7FFFFFC7) per matrici di byte e matrici di strutture a byte singolo e 2.146.435.071 (0X7FEFFFFF) per le 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 di tipo unsafe che usa matrici come buffer può essere soggetto a sovraccarichi del buffer se viene scritto nel presupposto che le matrici non superino i 2 GB.

Esempio

Nell'esempio riportato di seguito viene illustrato come abilitare questa funzionalità per un'applicazione.

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

Supportato in

.NET Framework 4,5 e versioni successive

Vedi anche