다음을 통해 공유


DbParameter.Size 속성

정의

열 내의 최대 데이터 크기(바이트)를 가져오거나 설정합니다.

public:
 abstract property int Size { int get(); void set(int value); };
public abstract int Size { get; set; }
member this.Size : int with get, set
Public MustOverride Property Size As Integer

속성 값

열 내의 최대 데이터 크기(바이트)입니다. 기본값은 매개 변수 값에서 유추됩니다.

구현

설명

속성은 이 Size 진 및 문자열 형식에 사용됩니다.

문자열이 아닌 데이터 형식 및 ANSI 문자열 데이터의 경우 속성은 Size 바이트 수를 나타냅니다. 유니코드 문자열 데이터의 경우 는 Size 문자 수를 나타냅니다. 문자열 개수에는 종결 문자가 포함되지 않습니다.

가변 길이 데이터 형식 Size 의 경우 는 서버로 전송할 최대 데이터 양을 설명합니다. 예를 들어 유니코드 문자열 값 Size 의 경우 를 사용하여 서버로 전송되는 데이터의 양을 처음 100자로 제한할 수 있습니다.

양방향 및 출력 매개 변수 및 반환 값의 Size경우 값을 설정해야 합니다. 입력 매개 변수에는 필요하지 않으며 명시적으로 설정되지 않은 경우 매개 변수가 있는 문이 실행될 때 지정된 매개 변수의 실제 크기에서 값이 유추됩니다.

매개 변수의 및 Size 속성은 DbType 를 설정Value하여 유추할 수 있습니다. 따라서 지정할 필요가 없습니다. 그러나 속성 설정에는 DbParameter 노출되지 않습니다. 예를 들어 매개 변수의 크기가 유추된 경우 는 Size 문 실행 후 유추된 값을 포함하지 않습니다.

고정 길이 데이터 형식의 경우 값 Size 은 무시됩니다. 정보 제공을 위해 검색할 수 있으며 매개 변수 값을 서버로 전송할 때 공급자가 사용하는 최대 바이트 양을 반환합니다.

에 대해 DbParameter 제공된 값의 크기가 지정된 SizeValue 초과하면 의 DbParameter 에 지정된 값이 포함되고 의 크기 DbParameter로 잘립니다.

형식DbTypeString의 매개 변수의 경우 값 Size 은 유니코드 문자의 길이입니다. 형식DbTypeXml의 매개 변수의 경우 는 Size 무시됩니다.

적용 대상

추가 정보