<gcAllowVery큰개체> 요소<gcAllowVeryLargeObjects> Element

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

<구성><configuration>
  <런타임>  <runtime>
    <gcAllowVery큰개체>    <gcAllowVeryLargeObjects>

구문Syntax

<gcAllowVeryLargeObjects
   enabled="true|false" />  

특성 및 요소Attributes and Elements

다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.The following sections describe attributes, child elements, and parent elements.

특성Attributes

attributeAttribute DescriptionDescription
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 DescriptionDescription
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 DescriptionDescription
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(0X7FFFFFFF)입니다.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 프레임워크 4.5 이상 버전.NET Framework 4.5 and later versions

참고 항목See also