[ADO.NET] SqlParameter 클래스 생성자, 속성

SqlParameter 클래스

 

 앞에서 SqlCommand 개체를 이용하여 명령을 수행하는 예를 보여주었는데 정적인 명령문의 형태만 보여주었습니다. 만약 명령을 수행할 때 매개 변수를 설정하여 작업을 수행하고자 한다면 SqlParameter 개체를 이용합니다.

 

SqlParameter 클래스는 명령 실행에 사용할 매개 변수를 설정할 때 사용하는 클래스입니다.

 

▷클래스 상속 계층

System.Object

  System.MarshalByRefObject

    System.Data.Common.DbParameter

      System.Data.SqlClient.SqlParameter

 

SqlParameter 생성자

 

 SqlParameter 클래스에는 6가지 생성자를 제공합니다.

 

SqlParameter ( );

SqlParameter ( string par_name, SqlDbType dbtype );

SqlParameter (string par_name, Object value );

SqlParameter (string par_name, SqlDbType dbtype, int size );

SqlParameter (string par_name, SqlDbType dbtype, int size, string column_name );

SqlParameter ( string par_name, SqlDbType dbtype, int size, ParameterDirection direction, bool nullable,

                    byte precision, byte scale, string column_name, DataRowVersion version, Object value );

SqlParameter ( string par_name, SqlDbType dbtype, int size, ParameterDirection direction, byte precision,

                    byte scale, string column_name, DataRowVersion version, Object value,

                    string xmlschema_collection_db, string xmlschema_collection_owning_schema,

                    string xmlschema_collection_name );

 

 SqlParameter 개체는 매개 변수 이름, 값, 형식, 길이, 방향, 전체 자릿수, 소수 자릿수, 소수 열의 이름, 버전, 소스 열 매핑 여부, XML 개체의 스키마 컬렉션이 있는 DB 이름, XML 개체의 스키마 컬렉션이 소유하는 관계형 스키마, 스키마 컬렉션 이름 등을 입력 인자로 전달하여 개체를 생성할 수 있습니다.

 

 SqlParameter 개체를 생성할 때 명확하게 결정한 사항은 전달하여 생성하고 나머지 사항은 디폴트 값이나 속성을 이용하여 결정할 수 있습니다.

 

 SqlParameter 개체는 독립적으로 어떠한 작업을 수행하는 것이 아니라 SqlCommand 개체의 Excute 명령 수행에 필요한 매개 변수를 결정하는 것이기 때문에 Excute 명령 수행 전에 필요한 값을 설정하면 됩니다.

 

 

 

SqlParameter 속성

 

 SqlParameter 클래스에는 명령에 사용할 매개 변수에 관한 다양한 속성을 제공하고 있습니다. 다음은 주요 속성입니다.

 

속성	가져오기/설정하기	설명
Direction	가져오기/설정하기	매개 변수의 용도를 설정 (입력 전용, 출력 전용, 양방향,반환 값)
IsNullable	가져오기/설정하기	null 허용 여부
ParameterName	가져오기/설정하기	매개변수 이름
Precision	가져오기/설정하기	Value 속성이 숫자일 때 최대 자릿 수
Scale	가져오기/설정하기	Value를 확인하는 소수 자릿 수
Size	가져오기/설정하기	데이터의 최대 크기(바이트 단위)
SoureceColumn	가져오기/설정하기	DataSet에 매핑하여 Value를 로드하거나 반환하기 위해 사용한 소스 열의 이름
SqlDbType	가져오기/설정하기	SqlDbType
SqlValue	가져오기/설정하기	SQL 형식의 매개 변수의 값
Value	가져오기/설정하기	매개 변수의 값

[표] SqlParameter 속성