<gcAllowVeryLargeObjects> Element<gcAllowVeryLargeObjects> Element

Na 64bitových platformách povoluje pole, jejichž celková velikost je větší než 2 gigabajty (GB).On 64-bit platforms, enables arrays that are greater than 2 gigabytes (GB) in total size.

<Element > Konfigurace<configuration> Element
<Běhový > element<runtime> Element
<gcAllowVeryLargeObjects> Element<gcAllowVeryLargeObjects> Element

SyntaxeSyntax

<gcAllowVeryLargeObjects    
   enabled="true|false" />  

Atributy a elementyAttributes and Elements

Následující části popisují atributy, podřízené prvky a nadřazené prvky.The following sections describe attributes, child elements, and parent elements.

AtributyAttributes

AtributAttribute PopisDescription
enabled Požadovaný atribut.Required attribute.

Určuje, zda jsou pole o celkové velikosti větší než 2 GB povolena na 64bitových platformách.Specifies whether arrays that are greater than 2 GB in total size are enabled on 64-bit platforms.

Atribut enabledenabled Attribute

ValueValue PopisDescription
false Pole o celkové velikosti větší než 2 GB nejsou povolena.Arrays greater than 2 GB in total size are not enabled. Toto nastavení je výchozí.This is the default.
true Pole o celkové velikosti větší než 2 GB jsou povolena na 64bitových platformách.Arrays greater than 2 GB in total size are enabled on 64-bit platforms.

Podřízené elementyChild Elements

ŽádnéNone.

Nadřazené elementyParent Elements

PrvekElement PopisDescription
configuration Kořenový prvek v každém konfiguračním souboru, který je používán modulem Common Language Runtime (CLR) a aplikacemi rozhraní .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.
runtime Obsahuje informace o možnostech inicializace modulu runtime.Contains information about runtime initialization options.

PoznámkyRemarks

Použití tohoto prvku v konfiguračním souboru aplikace umožňuje použití polí, která jsou větší než 2 GB, ale nedojde ke změně jiných omezení velikosti objektu nebo velikosti pole: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:

  • Maximální počet prvků v poli je UInt32.MaxValue.The maximum number of elements in an array is UInt32.MaxValue.

  • Maximální index v jakémkoli jednom rozměru je 2 147 483 591 (0x7FFFFFC7) pro bajtová pole a pole jednobajtových struktur a 2 146 435 071 (0X7FEFFFFF) pro ostatní typy.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.

  • Maximální velikost řetězců a dalších objektů mimo pole se nezmění.The maximum size for strings and other non-array objects is unchanged.

Upozornění

Před zapnutím této funkce je třeba se ujistit, že aplikace neobsahuje nebezpečný kód, což předpokládá, že jsou všechna pole menší než 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. Například nebezpečný kód, který používá pole jako vyrovnávací paměť, může být náchylný k přetečení zásobníku, pokud se při jeho psaní vycházelo z předpokladu, že pole nebude větší než 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.

PříkladExample

Následující příklad ukazuje, jak tuto funkci pro aplikaci povolit.The following example shows how to enable this feature for an application.

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

Podporováno v:Supported in

.NET Framework 4,5 a novější verze.NET Framework 4.5 and later versions

Viz také:See also