다음을 통해 공유


OleDbParameter.Size 속성

정의

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

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

속성 값

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

구현

특성

예제

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

Public Sub CreateOleDbParameter()  
    Dim myValue As String = "12 foot scarf - multiple colors, one previous owner"  
    Dim parameter As New OleDbParameter("Description", OleDbType.VarChar)  
    parameter.Direction = ParameterDirection.Output  
    parameter.Size = myValue.Length  
    parameter.Value = myValue  
End Sub 'CreateOleDbParameter  
public void CreateOleDbParameter()   
 {  
    string myValue = "12 foot scarf - multiple colors, one previous owner";  
    OleDbParameter parameter = new OleDbParameter("Description", OleDbType.VarChar);  
    parameter.Direction = ParameterDirection.Output;  
    parameter.Size = myValue.Length;  
    parameter.Value = myValue;  
 }  

설명

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

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

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

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

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

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

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

적용 대상

추가 정보