<gcAllowVeryLargeObjects > 요소<gcAllowVeryLargeObjects> Element

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

<구성 > 요소<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.

64 비트 플랫폼에서 총 크기가 2GB 보다 큰 배열을 사용 되는지 여부를 지정 합니다.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.

  • 임의의 단일 차원에 있는 최대 색인 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.

주의

이 기능을 사용 하기 전에 응용 프로그램 크기가 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>  

참고자료See also