35. [ADO.NET] SqlParameter 생성자와 속성

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

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

▷클래스 상속 계층

System.Object

  System.MarshalByRefObject

    System.Data.Common.DbParameter

      System.Data.SqlClient.SqlParameter

SqlParameter 생성자

  SqlParameter 클래스는 다양한 인자를 받는 생성자를 제공합니다.

 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

가져오기/설정하기

매개 변수의 값