SqlUserDefinedAggregateAttribute.MaxByteSize 속성

정의

네임스페이스:

Microsoft.Data.SqlClient.Server

어셈블리:

Microsoft.Data.SqlClient.dll

패키지:

Microsoft.Data.SqlClient v4.1.0

집계 인스턴스의 최대 크기(바이트)입니다.

public:
 property int MaxByteSize { int get(); void set(int value); };

public int MaxByteSize { get; set; }

member this.MaxByteSize : int with get, set

Public Property MaxByteSize As Integer

속성 값

Int32

집계 인스턴스의 최대 크기를 나타내는 Int32 값입니다.

설명

이 속성은 네이티브 형식 serialization에 대해 지정할 필요가 없습니다.

사용자 정의 serialization Format을 사용하여 속성을 지정 MaxByteSize 해야 합니다.

이 속성에 허용되는 최대값은 필드에 의해 MaxByteSizeValue 지정됩니다.

허용되는 최대 크기는 2GB입니다. 1에서 8000바이트까지의 숫자를 지정하거나 -1을 지정하여 최대 2기가바이트인 8000바이트보다 큰 값을 나타낼 수 있습니다.

사용자 정의 serialization이 지정된 MaxByteSize 집계의 경우 는 직렬화된 데이터의 총 크기를 나타냅니다. 문자열을 10자(Char)로 직렬화하는 집계를 고려합니다. 를 사용하여 BinaryWriter문자열을 직렬화하면 직렬화된 문자열의 총 크기는 22바이트( 유니코드 UTF-16자당 2바이트)이며, 최대 문자 수와 이진 스트림 직렬화로 인해 발생한 2개의 컨트롤 바이트 오버헤드를 곱합니다. 따라서 값을 MaxByteSize결정할 때 직렬화된 데이터의 총 크기를 고려해야 합니다. 이진 형식으로 직렬화된 데이터의 크기와 직렬화로 인해 발생하는 오버헤드를 고려해야 합니다.