<Elemento > gcAllowVeryLargeObjects<gcAllowVeryLargeObjects> Element

Nelle piattaforme a 64 bit, abilita le matrici con dimensione totale maggiore di 2 gigabyte (GB).On 64-bit platforms, enables arrays that are greater than 2 gigabytes (GB) in total size.

<Configuration >-elemento<configuration> Element
<Elemento runtime ><runtime> Element
<Elemento > gcAllowVeryLargeObjects<gcAllowVeryLargeObjects> Element

SintassiSyntax

<gcAllowVeryLargeObjects    
   enabled="true|false" />  

Attributi ed elementiAttributes and Elements

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.The following sections describe attributes, child elements, and parent elements.

AttributiAttributes

AttributoAttribute DescrizioneDescription
enabled Attributo obbligatorio.Required attribute.

Specifica se le matrici con dimensione totale più grande di 2 GB sono abilitate nelle piattaforme a 64 bit.Specifies whether arrays that are greater than 2 GB in total size are enabled on 64-bit platforms.

Attributo enabledenabled Attribute

ValoreValue DESCRIZIONEDescription
false Le matrici con dimensione totale più grande di 2 GB non sono abilitate.Arrays greater than 2 GB in total size are not enabled. Questa è l'impostazione predefinita.This is the default.
true Le matrici con dimensione totale più grande di 2 GB sono abilitate nelle piattaforme a 64 bit.Arrays greater than 2 GB in total size are enabled on 64-bit platforms.

Elementi figlioChild Elements

Nessuno.None.

Elementi padreParent Elements

ElementoElement DescrizioneDescription
configuration Elemento radice in ciascun file di configurazione usato in Common Language Runtime e nelle applicazioni .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.
runtime Contiene informazioni sulle opzioni di inizializzazione in fase di esecuzione.Contains information about runtime initialization options.

NoteRemarks

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: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:

  • Il numero massimo di elementi in una matrice è UInt32.MaxValue.The maximum number of elements in an array is UInt32.MaxValue.

  • L'indice massimo in ogni singola dimensione è 2.147.483.591 (0x7FFFFFC7) per le matrici di byte e le matrici di strutture a byte singolo e 2.146.435.071 (0X7FEFFFFF) per gli altri tipi.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.

  • La dimensione massima consentita per le stringhe e altri oggetti diversi da matrici è invariata.The maximum size for strings and other non-array objects is unchanged.

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.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. Ad esempio, il codice di tipo unsafe in cui le matrici vengono utilizzate come buffer può essere soggetto a sovraccarichi del buffer se viene scritto partendo dal presupposto che le matrici non superino i 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.

EsempioExample

Nell'esempio riportato di seguito viene illustrato come abilitare questa funzionalità per un'applicazione.The following example shows how to enable this feature for an application.

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

Supportato inSupported in

.NET Framework 4,5 e versioni successive.NET Framework 4.5 and later versions

Vedere ancheSee also