<gcAllowVeryLargeObjects> 要素

  • [アーティクル]

64 ビット プラットフォームで、合計サイズが 2 GB (ギガバイト) を超える配列を有効にします。

configuration
  runtime
    <gcAllowVeryLargeObjects>

構文

<gcAllowVeryLargeObjects enabled="true|false" />

属性

属性 説明
enabled 必須の属性です。

64 ビット プラットフォームで、合計サイズが 2 GB (ギガバイト) を超える配列が有効であるかどうかを指定します。

enabled 属性

[値] 説明
false 合計サイズが 2 GB を超える配列は有効ではありません。 既定値です。
true 64 ビット プラットフォームで、合計サイズが 2 GB を超える配列が有効になっています。

子要素

なし。

親要素

要素 説明
configuration 共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。
runtime ランタイム初期化オプションに関する情報を含んでいます。

解説

アプリケーション構成ファイルで次の要素を使用すると 2 GB を超えるサイズの配列が有効になりますが、オブジェクトのサイズや配列のサイズに対するその他の制限は変更されません。

  • 配列の要素の最大数は UInt32.MaxValue です。

  • バイト配列および 1 バイト構造体の配列の場合、単一次元の最大サイズは 2,147,483,591 (0x7FFFFFC7) です。その他の型を含む配列の場合は 2,146,435,071 (0X7FEFFFFF) です。

  • 文字列およびその他の非配列オブジェクトの最大サイズは変更されません。

注意事項

この機能を有効にする前に、すべての配列のサイズが 2 GB よりも小さいことを前提としたアンセーフ コードがアプリケーションに含まれていないことを確認します。 たとえば、バッファーとして配列を使用するアンセーフ コードが、配列は 2 GB を超えないという前提で記述されている場合、バッファー オーバーランが発生しやすくなる可能性があります。

例

次の app.config ファイルのスニペットでは、.NET Framework アプリケーションでこの機能を有効にする方法が示されています。

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

サポート対象 :

.NET Framework 4.5 以降のバージョン

関連項目