<Elementet gcAllowVeryLargeObjects>

Artikel
05/10/2023

På 64-bitarsplattformar aktiverar matriser som är större än 2 GIGABYTE (GB) i total storlek.

<Konfiguration>
<Runtime>
<gcAllowVeryLargeObjects>

Syntax

<gcAllowVeryLargeObjects enabled="true|false" />

Attribut

Attribut	Beskrivning
`enabled`	Obligatoriskt attribut. Anger om matriser som är större än 2 GB i total storlek är aktiverade på 64-bitarsplattformar.

aktiverat attribut

Värde	Beskrivning
`false`	Matriser som är större än 2 GB i total storlek är inte aktiverade. Det här är standardinställningen.
`true`	Matriser som är större än 2 GB i total storlek aktiveras på 64-bitarsplattformar.

Underordnade element

Inga.

Överordnade element

Element	Beskrivning
`configuration`	Rotelementet i varje konfigurationsfil som används av den vanliga språkkörningen och .NET Framework program.
`runtime`	Innehåller information om initieringsalternativ för körning.

Kommentarer

Med det här elementet i programkonfigurationsfilen kan du använda matriser som är större än 2 GB, men som inte ändrar andra gränser för objektstorlek eller matrisstorlek:

Det maximala antalet element i en matris är UInt32.MaxValue.
Den maximala storleken i en enskild dimension är 2 147 483 591 (0x7FFFFFC7) för bytematriser och matriser med enkla bytestrukturer och 2 146 435 071 (0X7FEFFFFF) för matriser som innehåller andra typer.
Den maximala storleken för strängar och andra icke-matrisobjekt är oförändrad.

Varning

Innan du aktiverar den här funktionen kontrollerar du att programmet inte innehåller osäker kod som förutsätter att alla matriser är mindre än 2 GB i storlek. Till exempel kan osäker kod som använder matriser som buffertar vara sårbar för buffertöverskridanden om den skrivs med antagandet att matriserna inte kommer att överstiga 2 GB.

Exempel

Följande app.config filfragment visar hur du aktiverar den här funktionen för ett .NET Framework program.

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

Stöds i

.NET Framework 4.5 och senare versioner

Dela via