<gcAllowVeryLargeObjects >, élément<gcAllowVeryLargeObjects> Element

Sur les plateformes 64 bits, autorise les tableaux dont la taille totale est supérieure à 2 gigaoctets (Go).On 64-bit platforms, enables arrays that are greater than 2 gigabytes (GB) in total size.

<configuration> <configuration>
   <> d’exécution  <runtime>
     <gcAllowVeryLargeObjects>    <gcAllowVeryLargeObjects>

SyntaxeSyntax

<gcAllowVeryLargeObjects    
   enabled="true|false" />  

Attributs et élémentsAttributes and Elements

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.The following sections describe attributes, child elements, and parent elements.

AttributsAttributes

AttributAttribute DescriptionDescription
enabled Attribut requis.Required attribute.

Spécifie si les tableaux dont la taille totale est supérieure à 2 Go sont activés sur les plateformes 64 bits.Specifies whether arrays that are greater than 2 GB in total size are enabled on 64-bit platforms.

Attribut enabledenabled Attribute

ValeurValue DescriptionDescription
false Les tableaux d’une taille totale supérieure à 2 Go ne sont pas activés.Arrays greater than 2 GB in total size are not enabled. Il s'agit de la valeur par défaut.This is the default.
true Les tableaux d’une taille totale supérieure à 2 Go sont activés sur les plateformes 64 bits.Arrays greater than 2 GB in total size are enabled on 64-bit platforms.

Éléments enfantsChild Elements

Aucun.None.

Éléments parentsParent Elements

ÉlémentElement DescriptionDescription
configuration Élément racine de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.
runtime Contient des informations sur les options d'initialisation du runtime.Contains information about runtime initialization options.

NotesRemarks

L’utilisation de cet élément dans le fichier de configuration de votre application permet aux tableaux dont la taille est supérieure à 2 Go, mais ne modifie pas les autres limites de taille d’objet ou de taille de tableau :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:

  • Le nombre maximal d’éléments dans un tableau est UInt32.MaxValue.The maximum number of elements in an array is UInt32.MaxValue.

  • L’index maximal dans une dimension unique est 2 147 483 591 (0x7FFFFFC7) pour les tableaux d’octets et les tableaux de structures sur un octet, et 2 146 435 071 (0X7FEFFFFF) pour d’autres types.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 taille maximale des chaînes et d’autres objets non-tableau est inchangée.The maximum size for strings and other non-array objects is unchanged.

Attention

Avant d’activer cette fonctionnalité, assurez-vous que votre application n’inclut pas de code non sécurisé qui suppose que la taille de tous les tableaux est inférieure à 2 Go.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. Par exemple, le code unsafe qui utilise des tableaux comme mémoires tampons peut être vulnérable aux dépassements de mémoire tampon s’il est écrit en supposant que les tableaux ne dépasseront pas 2 Go.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.

ExemplesExample

L’exemple suivant montre comment activer cette fonctionnalité pour une application.The following example shows how to enable this feature for an application.

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

Pris en charge dansSupported in

.NET Framework 4,5 et versions ultérieures.NET Framework 4.5 and later versions

Voir aussiSee also