다음을 통해 공유


SqlParameter.Size 속성

정의

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

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

속성 값

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

구현

예제

다음 예에서는 을 SqlParameter 만들고 일부 속성을 설정합니다.

// using Microsoft.Data.SqlClient;
static void CreateSqlParameterSize()
{
    string description = "12 foot scarf - multiple colors, one previous owner";
    SqlParameter parameter = new SqlParameter("Description", SqlDbType.VarChar);
    parameter.Direction = ParameterDirection.InputOutput;
    parameter.Size = description.Length;
    parameter.Value = description;
}

설명

반환 값은 이 속성의 영향을 받지 않습니다. 저장 프로시저의 반환 매개 변수는 항상 고정 크기 정수입니다.

가변 길이 형식(예: nvarchar)이 있는 출력 매개 변수의 경우 매개 변수의 크기는 출력 매개 변수를 보유하는 버퍼의 크기를 정의합니다. 출력 매개 변수는 로 지정된 Size크기로 잘립니다. 문자 형식의 경우 로 Size 지정된 크기는 문자 단위입니다.

속성은 이 Size 진 및 문자열 형식에 사용됩니다. 형식 SqlType.StringSize 의 매개 변수의 경우 유니코드 문자의 길이를 의미합니다. 형식 SqlType.XmlSize 의 매개 변수의 경우 는 무시됩니다.

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

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

명시적으로 설정하지 않으면 크기가 지정된 매개 변수 값의 실제 크기에서 유추됩니다.

매개 변수 값의 소수 부분이 크기보다 크면 값이 크기와 일치하도록 잘립니다.

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

스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

적용 대상