다음을 통해 공유

SqlParameter.Size 속성

정의

네임스페이스:
System.Data.SqlClient
어셈블리:
System.Data.SqlClient.dll
어셈블리:
System.Data.dll
Source:
System.Data.SqlClient.notsupported.cs

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

public:
 virtual property int Size { int get(); void set(int value); };
public:
 property int Size { int get(); void set(int value); };
public override int Size { get; set; }
[System.Data.DataSysDescription("DbDataParameter_Size")]
public int Size { get; set; }
member this.Size : int with get, set
[<System.Data.DataSysDescription("DbDataParameter_Size")>]
member this.Size : int with get, set
Public Overrides Property Size As Integer
Public Property Size As Integer

속성 값

Int32

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

구현

Size
특성
DataSysDescriptionAttribute

예제

다음 예제에서는 해당 SqlParameter 속성 중 일부를 만들고 설정합니다.

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;
}

Private Sub CreateSqlParameterSize()
    Dim description As String = "12 foot scarf - multiple colors, one previous owner"
    Dim parameter As New SqlParameter("Description", SqlDbType.VarChar)
    parameter.Direction = ParameterDirection.InputOutput
    parameter.Size = description.Length
    parameter.Value = description
End Sub

설명

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

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

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

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

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

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

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

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

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

적용 대상

추가 정보