<Элемент gcAllowVeryLargeObjects>

Мақала
06/21/2023

На 64 разрядных платформах позволяет использовать массивы, размер которых превышает 2 гигабайта (ГБ).

<настройка>
<Среды выполнения>
<gcAllowVeryLargeObjects>

Синтаксис

<gcAllowVeryLargeObjects enabled="true|false" />

Атрибуты

Атрибут	Описание
`enabled`	Обязательный атрибут. Указывает, включены ли на 64-разрядных платформах массивы, размер которых превышает 2 ГБ.

атрибут enabled

Значение	Описание
`false`	Массивы, размер которых превышает 2 ГБ, не включены. Это значение по умолчанию.
`true`	На 64-разрядных платформах включены массивы общего размера размером более 2 ГБ.

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

Отсутствует.

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

Элемент	Описание
`configuration`	Корневой элемент в любом файле конфигурации, используемом средой CLR и приложениями .NET Framework.
`runtime`	Содержит сведения о параметрах инициализации среды выполнения.

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

Максимальное число элементов в массиве равно UInt32.MaxValue.
Максимальный размер в одном измерении составляет 2 147 483 591 (0x7FFFFFC7) для массивов байтов и массивов однобайтовых структур и 2 146 435 071 (0X7FEFFFFF) для массивов, содержащих другие типы.
Максимальный размер строк и других объектов, не относящихся к массиву, не изменяется.

Внимание!

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

Пример

В следующем фрагменте файлаapp.config показано, как включить эту функцию для приложения платформа .NET Framework.

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

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

платформа .NET Framework 4.5 и более поздних версий

Бөлісу құралы: