<gcAllowVeryLargeObjects> Element<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 > élément<configuration> Element
<runtime > élément<runtime> Element
<gcAllowVeryLargeObjects> Element<gcAllowVeryLargeObjects> Element

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 qui sont supérieures à 2 Go de taille totale 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

ValueValue DescriptionDescription
false Supérieure à 2 Go de taille totale des tableaux 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 Supérieure à 2 Go de taille totale des tableaux 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’aide de cet élément dans votre fichier de configuration d’application permet de tableaux supérieurs à 2 Go, mais ne modifie pas les autres limites concernant la taille de l’objet ou de la taille du 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 n’importe quelle dimension unique est 2,147,483,591 (0x7FFFFFC7) pour les tableaux d’octets et des tableaux de structures d’un octet et 2,146,435,071 (0X7FEFFFFF) pour les 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 pour les chaînes et autres objets autres que des tableaux 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 le code unsafe qui part du principe que tous les tableaux sont inférieures à 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 qui utilise des tableaux de mémoires tampons unsafe peut-être expose à des dépassements de mémoire tampon s’il est écrit sur l’hypothèse que les tableaux ne dépassent 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.

ExempleExample

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>  

Voir aussiSee also