<Элемент gcAllowVeryLargeObjects>

На 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 и более поздних версий

См. также раздел