элемент <gcAllowVeryLargeObjects>

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

<configuration>
  <runtime>
    <gcAllowVeryLargeObjects>

Синтаксис

<gcAllowVeryLargeObjects enabled="true|false" />

Attributes

Свойство Description
enabled Обязательный атрибут.

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

атрибут включено

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

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

Нет.

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

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

Замечания

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

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

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

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

Caution

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

Example

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

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

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

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

См. также

  • Last updated on