<gcAllowVeryLargeObjects> 要素<gcAllowVeryLargeObjects> element

64 ビット プラットフォームで、合計サイズが 2 GB (ギガバイト) を超える配列を有効にします。On 64-bit platforms, enables arrays that are greater than 2 gigabytes (GB) in total size.



<gcAllowVeryLargeObjects enabled="true|false" />  


属性Attribute 説明Description
enabled 必須の属性です。Required attribute.

64 ビット プラットフォームで、合計サイズが 2 GB (ギガバイト) を超える配列が有効であるかどうかを指定します。Specifies whether arrays that are greater than 2 GB in total size are enabled on 64-bit platforms.

enabled 属性enabled attribute

Value 説明Description
false 合計サイズが 2 GB を超える配列は有効ではありません。Arrays greater than 2 GB in total size are not enabled. 既定値です。This is the default.
true 64 ビット プラットフォームで、合計サイズが 2 GB を超える配列が有効になっています。Arrays greater than 2 GB in total size are enabled on 64-bit platforms.

子要素Child elements


親要素Parent elements

要素Element 説明Description
configuration 共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。The root element in every configuration file used by the common language runtime and .NET Framework applications.
runtime ランタイム初期化オプションに関する情報を含んでいます。Contains information about runtime initialization options.


アプリケーション構成ファイルで次の要素を使用すると 2 GB を超えるサイズの配列が有効になりますが、オブジェクトのサイズや配列のサイズに対するその他の制限は変更されません。Using this element in your application configuration file enables arrays that are larger than 2 GB in size, but does not change other limits on object size or array size:

  • 配列の要素の最大数は UInt32.MaxValue です。The maximum number of elements in an array is UInt32.MaxValue.

  • 1つの次元の最大サイズは、バイト配列と1バイト構造の配列の場合は 2147483591 (0x7FFFFFC7)、他の型を含む配列の場合は 2146435071 (0X7FEFFFFF) です。The maximum size in any single dimension is 2,147,483,591 (0x7FFFFFC7) for byte arrays and arrays of single-byte structures, and 2,146,435,071 (0X7FEFFFFF) for arrays containing other types.

  • 文字列およびその他の非配列オブジェクトの最大サイズは変更されません。The maximum size for strings and other non-array objects is unchanged.


この機能を有効にする前に、すべての配列のサイズが 2 GB よりも小さいことを前提としたアンセーフ コードがアプリケーションに含まれていないことを確認します。Before enabling this feature, ensure that your application does not include unsafe code that assumes that all arrays are smaller than 2 GB in size. たとえば、配列をバッファーとして使用するアンセーフコードは、配列が 2 GB を超えることを想定して記述されている場合、バッファーオーバーランの影響を受ける可能性があります。For example, unsafe code that uses arrays as buffers might be susceptible to buffer overruns if it's written on the assumption that arrays will not exceed 2 GB.


アプリケーションでこの機能を有効にする方法を次の例に示します。The following example shows how to enable this feature for an application.

    <gcAllowVeryLargeObjects enabled="true" />  

サポート対象 :Supported in

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

関連項目See also