Элемент <gcAllowVeryLargeObjects>

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

<configuration>
  <runtime>
    <gcAllowVeryLargeObjects>

Синтаксис

<gcAllowVeryLargeObjects enabled="true|false" />  

Атрибуты

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

Указывает, включены ли на 64-разрядных платформах массивы размером более 2 ГБ.

Включенный атрибут

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

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

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

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

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

Remarks

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

  • Максимальное число элементов в массиве — UInt32.MaxValue .

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

  • Максимальный размер строк и других объектов, не являющихся массивами, не изменяется.

Внимание!

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

Пример

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

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

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

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

См. также