<Gcallowverylargeobjects> > 요소<gcAllowVeryLargeObjects> Element

64비트 플랫폼에서 총 크기가 2GB보다 큰 배열을 사용하도록 설정합니다.On 64-bit platforms, enables arrays that are greater than 2 gigabytes (GB) in total size.

<configuration > 요소<configuration> Element
<런타임 > 요소<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.

총 크기에서 2gb 보다 큰 배열을 64 비트 플랫폼에서 사용할 수 있는지 여부를 지정 합니다.Specifies whether arrays that are greater than 2 GB in total size are enabled on 64-bit platforms.

enabled 특성enabled Attribute

Value 설명Description
false 전체 크기의 2gb 보다 큰 배열은 사용할 수 없습니다.Arrays greater than 2 GB in total size are not enabled. 이 값이 기본값입니다.This is the default.
true 총 크기가 2gb 보다 큰 배열은 64 비트 플랫폼에서 사용 하도록 설정 됩니다.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.

설명Remarks

응용 프로그램 구성 파일에서이 요소를 사용 하면 크기가 2gb 보다 큰 배열은 가능 하지만 개체 크기나 배열 크기에 대 한 다른 제한은 변경 되지 않습니다.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.

  • 단일 차원의 최대 인덱스는 바이트 배열 및 단일 바이트 구조의 배열에 대해 2147483591 (0x7FFFFFC7)이 고 다른 형식의 경우 2146435071 (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.

주의

이 기능을 사용 하도록 설정 하기 전에 모든 배열이 2gb 보다 작은 것으로 가정 하는 안전 하지 않은 코드가 응용 프로그램에 포함 되지 않도록 합니다.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. 예를 들어 배열을 버퍼로 사용 하는 안전 하지 않은 코드는 배열이 2gb를 초과 하지 않는다는 가정 하에 작성 되는 경우 버퍼 오버런에 취약할 수 있습니다.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>  

다음에서 지원:Supported in

.NET Framework 4.5 이상 버전.NET Framework 4.5 and later versions

참고자료See also