<gcAllowVeryLargeObjects > 要素<gcAllowVeryLargeObjects> Element

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

<configuration > 要素<configuration> Element
<runtime> 要素<runtime> Element
<gcAllowVeryLargeObjects > 要素<gcAllowVeryLargeObjects> Element

構文Syntax

<gcAllowVeryLargeObjects    
   enabled="true|false" />  

属性および要素Attributes and Elements

以降のセクションでは、属性、子要素、および親要素について説明します。The following sections describe attributes, child elements, and parent elements.

属性Attributes

属性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

なし。None.

親要素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.

RemarksRemarks

アプリケーション構成ファイルで次の要素を使用すると 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 バイト構造体の配列の場合、単一次元の最大インデックスは 2,147,483,591 (0x7FFFFFC7) です。その他の種類の場合は 2,146,435,071 (0X7FEFFFFF) です。The maximum index 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 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 is written on the assumption that arrays will not exceed 2 GB.

Example

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

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

関連項目See also