<Het element gcAllowVeryLargeObjects>

Artikel
07/07/2023

Op 64-bits platforms schakelt u matrices in die groter zijn dan 2 gigabyte (GB) in totale grootte.

<Configuratie>
<Runtime>
<gcAllowVeryLargeObjects>

Syntax

<gcAllowVeryLargeObjects enabled="true|false" />

Kenmerken

Kenmerk	Beschrijving
`enabled`	Vereist kenmerk. Hiermee geeft u op of matrices die groter zijn dan 2 GB in totale grootte zijn ingeschakeld op 64-bits platforms.

kenmerk ingeschakeld

Waarde	Beschrijving
`false`	Matrices die groter zijn dan 2 GB in totale grootte, zijn niet ingeschakeld. Dit is de standaardinstelling.
`true`	Matrices die groter zijn dan 2 GB in totale grootte, worden ingeschakeld op 64-bits platforms.

Onderliggende elementen

Geen.

Bovenliggende elementen

Element	Beschrijving
`configuration`	Het hoofdelement in elk configuratiebestand dat wordt gebruikt door de common language runtime en .NET Framework toepassingen.
`runtime`	Bevat informatie over opties voor runtime-initialisatie.

Opmerkingen

Als u dit element gebruikt in het configuratiebestand van uw toepassing, worden matrices ingeschakeld die groter zijn dan 2 GB, maar worden andere limieten voor objectgrootte of matrixgrootte niet gewijzigd:

Het maximum aantal elementen in een matrix is UInt32.MaxValue.
De maximale grootte in een enkele dimensie is 2.147.483.591 (0x7FFFFFC7) voor bytematrices en matrices met enkelvoudige-bytestructuren en 2.146.435.071 (0X7FEFFFFF) voor matrices met andere typen.
De maximale grootte voor tekenreeksen en andere niet-matrixobjecten blijft ongewijzigd.

Waarschuwing

Voordat u deze functie inschakelt, moet u ervoor zorgen dat uw toepassing geen onveilige code bevat die ervan uitgaat dat alle matrices kleiner zijn dan 2 GB. Onveilige code die matrices als buffers gebruikt, kan bijvoorbeeld gevoelig zijn voor bufferoverschrijdingen als deze is geschreven in de veronderstelling dat matrices niet groter zijn dan 2 GB.

Voorbeeld

Het volgende app.config bestandsfragment laat zien hoe u deze functie inschakelt voor een .NET Framework-toepassing.

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

Ondersteund in

.NET Framework 4.5 en latere versies

Delen via