방법: 데이터 어댑터에 대한 매개 변수 구성
업데이트: 2007년 11월
대부분의 경우 데이터 어댑터의 Command 개체(SelectCommand, InsertCommand, UpdateCommand 및 DeleteCommand)는 매개 변수가 필요한 SQL 문이나 저장 프로시저를 참조합니다. 데이터 어댑터 구성 마법사를 사용하여 어댑터를 만들면 이러한 명령의 매개 변수가 자동적으로 구성됩니다. 그러나 매개 변수를 직접 구성하거나 기존 매개 변수 컬렉션을 약간 변경해야 할 수도 있습니다.
.gif "참고") 참고: |
|---|
이전 버전의 Visual Studio에서는 응용 프로그램과 데이터베이스 간의 통신에 데이터 어댑터를 사용했습니다. 이전과 마찬가지로 데이터 어댑터는 .NET Framework 데이터 공급자(ADO.NET)의 주 구성 요소이지만 TableAdapter는 응용 프로그램과 데이터베이스 간의 데이터 이동 프로세스를 간단하게 만들기 위해 디자이너에서 생성한 구성 요소입니다. TableAdapter 작업에 대한 자세한 내용은 TableAdapter 개요를 참조하십시오. |
| 팁: |
|---|
명령의 SQL 문을 변경한 후에 매개 변수를 구성하려면 쿼리 작성기에서 해당 명령에 대한 매개 변수 컬렉션 다시 생성 옵션을 선택합니다. |
| 참고: |
|---|
실제 설정이나 버전에 따라서 화면에 나타나는 대화 상자와 메뉴 명령이 도움말의 설명과 다를 수 있습니다. 설정을 변경하려면 도구 메뉴에서 설정 가져오기 및 내보내기를 선택합니다. 자세한 내용은 Visual Studio 설정을 참조하십시오. |
데이터 어댑터의 매개 변수를 구성하려면
데이터 어댑터를 만듭니다. 자세한 내용은 데이터 어댑터 만들기를 참조하십시오.
폼 또는 구성 요소 디자이너에서 데이터 어댑터를 선택한 다음 속성 창을 엽니다.
매개 변수를 구성할 명령 개체(예: UpdateCommand)를 확장한 다음 Parameters 속성에서 줄임표(...) 단추를 클릭하여 매개 변수 컬렉션 편집기 창을 엽니다.
매개 변수 개체를 새로 만들려면 추가를 클릭합니다.
정렬 아래의 화살표를 클릭하여 이동시키는 방식으로 새 매개 변수를 해당 매개 변수에 대한 컬렉션의 올바른 인덱스 위치에 놓습니다.
매개 변수의 속성을 설정하려면 멤버 목록에서 매개 변수를 선택한 다음 오른쪽의 속성 표을 사용합니다. 다음 표에 일반적으로 설정되는 속성의 목록이 나와 있습니다.
속성
설명
SourceColumn
매개 변수 값을 읽을 데이터 집합 테이블의 열 이름입니다. 이 속성은 UPDATE, INSERT 또는 DELETE 문(또는 이에 해당하는 저장 프로시저)에서 값을 입력하는 매개 변수와 함께 사용됩니다.
SourceVersion
매개 변수 값이 SourceColumn 속성을 통해 파생된 경우 SourceVersion은 다음과 같이 매개 변수 값 소스로 사용할 데이터 집합 레코드의 버전을 지정합니다.
Original - 데이터베이스에서 읽어 왔을 때의 열 값입니다. 이 옵션은 변경되기 전의 열 값이 필요한 경우에 사용합니다. 예를 들어 기본 키를 변경했지만 데이터베이스의 레코드를 찾는 데 이전 키가 필요한 경우에 해당합니다.
Current - 레코드가 업데이트된 후의 열 값입니다. 이 값은 대개 데이터베이스에 쓸 값입니다.
Default - 명시적으로 제공된 값이 없는 경우 열에 설정할 값입니다.
Value
매개 변수에 대해 설정되는 명시적인 값입니다. 이 속성은 종종 디자인 타임에 정적으로 설정되지 않고 런타임에 설정됩니다.
Value 속성과 SourceColumn 속성을 모두 설정하는 경우 Value 속성이 우선 순위를 갖습니다.
NamedParameter
매개 변수가 변수(대개 @parametername 형식) 또는 자리 표시자(대개 물음표)에 대응하는지 나타내는 부울 값입니다. SqlConnection 개체로 작업하고 명명된 매개 변수를 사용하는 경우 이 속성을 true로 설정합니다.
DBType, Precision, Scale, Size
데이터 저장소에 있는 매개 변수 값의 네이티브 데이터 형식에 대한 정보입니다. 매개 변수 값이 지정한 형식으로 또는 지정한 형식에서 변환됩니다.
Direction
매개 변수 값이 명령으로 전달되는지 또는 반환되는지를 지정합니다.
Input - 명령에 전달되는 값입니다. 이 값이 기본값입니다.
Output - 저장 프로시저에서 다시 전달되는 값입니다. SQL 문에는 사용할 수 없습니다.
InputOutput - 저장 프로시저에 전달되고 대개 수정된 값으로 다시 전달되는 값입니다.
ReturnValue - 명시적 반환 값입니다. 기본적으로 반환된 값은 매개 변수 컬렉션에서 인덱스 값이 0인 첫 번째 항목입니다.
ParameterName
인덱스 값으로 참조하는 대신 컬렉션의 매개 변수에 대해 참조할 수 있는 이름입니다. 쉽게 관리하려면 매개 변수 이름을 사용하는 것이 좋습니다.
확인을 클릭하여 매개 변수 컬렉션 편집기 창을 닫습니다.
다른 명령 개체의 매개 변수를 구성하려면 3-5단계를 반복합니다.