<Элемент > gcAllowVeryLargeObjects<gcAllowVeryLargeObjects> Element

На 64 разрядных платформах позволяет использовать массивы, размер которых превышает 2 гигабайта (ГБ).On 64-bit platforms, enables arrays that are greater than 2 gigabytes (GB) in total size.

<configuration> <configuration>
   <> среды выполнения  <runtime>
     <gcAllowVeryLargeObjects >    <gcAllowVeryLargeObjects>

СинтаксисSyntax

<gcAllowVeryLargeObjects    
   enabled="true|false" />  

Атрибуты и элементыAttributes and Elements

В следующих разделах описаны атрибуты, дочерние и родительские элементы.The following sections describe attributes, child elements, and parent elements.

АтрибутыAttributes

АтрибутAttribute ОписаниеDescription
enabled Обязательный атрибут.Required attribute.

Указывает, включены ли на 64-разрядных платформах массивы размером более 2 ГБ.Specifies whether arrays that are greater than 2 GB in total size are enabled on 64-bit platforms.

Атрибут enabledenabled Attribute

ЗначениеValue ОписаниеDescription
false Массивы объемом более 2 ГБ не включены.Arrays greater than 2 GB in total size are not enabled. Это значение по умолчанию.This is the default.
true Массивы объемом более 2 ГБ включены на 64-разрядных платформах.Arrays greater than 2 GB in total size are enabled on 64-bit platforms.

Дочерние элементыChild Elements

Нет.None.

Родительские элементыParent Elements

ЭлементElement ОписаниеDescription
configuration Корневой элемент в любом файле конфигурации, используемом средой CLR и приложениями .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.
runtime Содержит сведения о параметрах инициализации среды выполнения.Contains information about runtime initialization options.

ПримечанияRemarks

Использование этого элемента в файле конфигурации приложения позволяет использовать массивы размером более 2 ГБ, но не изменяет другие ограничения на размер объекта или размер массива: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:

  • Максимальное число элементов в массиве — UInt32.MaxValue.The maximum number of elements in an array is UInt32.MaxValue.

  • Максимальный индекс в любом отдельном измерении — 2 147 483 591 (0x7FFFFFC7) для массивов байтов и массивов однобайтовых структур, а также 2 146 435 071 (0X7FEFFFFF) для других типов.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.

  • Максимальный размер строк и других объектов, не являющихся массивами, не изменяется.The maximum size for strings and other non-array objects is unchanged.

Внимание!

Перед включением этой функции убедитесь, что приложение не включает в себя ненадежный код, который предполагает, что размер всех массивов меньше 2 ГБ.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. Например, ненадежный код, использующий массивы как буферы, может быть уязвим для переполнения буфера, если он написан на основе предположения, что массивы не будут превышать 2 ГБ.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.

ПримерExample

В следующем примере показано, как включить эту функцию для приложения.The following example shows how to enable this feature for an application.

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

Поддерживается вSupported in

.NET Framework 4,5 и более поздних версий.NET Framework 4.5 and later versions

См. такжеSee also