매개 변수 컬렉션 편집기

TableAdapters와 데이터 어댑터에서 SQL 문 또는 저장 프로시저와 관련된 매개 변수(OleDbParameter, SqlParameter, OdbcParameterOracleParameter 개체)를 만들고 구성할 수 있습니다.

매개 변수 컬렉션 편집

매개 변수 컬렉션 편집기속성 창을 사용하여 데이터 집합 디자이너에서 TableAdapter를 구성하거나, 폼 또는 구성 요소에서 데이터 어댑터를 구성할 때 표시됩니다.

데이터 집합 디자이너 화면에서 TableAdapter를 선택한 다음 속성 창에서 매개 변수 속성을 선택하여 매개 변수 컬렉션 편집기를 엽니다.

  1. SelectCommand, UpdateCommand, InsertCommandDeleteCommand 속성의 노드를 엽니다.

  2. 매개 변수 속성을 편집하여 매개 변수 컬렉션 편집기를 엽니다.

참고

TableAdapter 구성 마법사와 같은 데이터 디자인 도구 또는 데이터 어댑터 구성 마법사를 사용하여 어댑터를 구성하는 경우 어댑터의 매개 변수가 자동으로 구성됩니다.

매개 변수 이름 지정

이러한 명령의 문이나 저장 프로시저는 매개 변수 자리 표시자를 사용하여 정의할 수 있습니다.

OleDbDataAdapter 개체를 사용하는 경우에는 문이 물음표를 자리 표시자로 사용합니다. 예를 들면, 다음과 같습니다.

Select * From Customers Where City = ?

또한 SqlDataAdapter 개체를 사용하는 경우에는 문이 명명된 매개 변수를 사용합니다. 예를 들면, 다음과 같습니다.

Select * From Customers Where City = @City

OracleDataAdapter 개체를 사용하는 경우 Oracle 명명 매개 변수를 사용하는 문은 다음과 같습니다.

SELECT * FROM Customers WHERE CustomerID = :pCustomerID

참고

Oracle의 경우, SQL 문이나 저장 프로시저에서 명명된 매개 변수를 사용할 때는 매개 변수 이름 앞에 콜론(:)을 붙여야 합니다. 그러나 예를 들어, 코드에서 Add 메서드를 호출할 때처럼 명명된 매개 변수를 참조할 때는 명명된 매개 변수 앞에 콜론(:)을 붙이지 마십시오. 데이터 공급자에서 콜론을 자동으로 제공합니다.

매개 변수 추가

명령(예: Parameters)에 대한 Parameters 컬렉션에는 런타임에 문이나 저장 프로시저에 값을 전달하는 데 사용되는 매개 변수 개체 목록이 포함되어 있습니다. 여기에는 명령에 전달해야 하는 각 매개 변수 값에 대한 매개 변수 개체가 존재합니다.

열 컬렉션 편집기는 두 개의 창으로 구분되어 있습니다. 왼쪽 창에서는 매개 변수를 추가하거나 제거하며 오른쪽 창에서는 다음 사항을 포함한 개별 매개 변수의 속성을 설정합니다.

  • ParameterName 속성. 이 속성을 사용하면 코드에서 매개 변수를 참조할 수 있습니다.

    참고

    SqlDataAdapter 클래스에는 명명된 매개 변수가 필요하므로 SqlParameter 개체의 이름 앞에는 항상 "@" 기호가 와야 합니다.

  • SourceColumn 속성. 이 속성은 데이터 레코드에서 매개 변수 값이 파생된 위치를 식별합니다. 이 값은 업데이트 작업 중에 사용됩니다. 데이터 어댑터는 특정 열의 값을 업데이트 명령에 전달합니다.

  • SourceVersion 속성. 이 속성은 SourceColumn 속성과 함께 사용됩니다. 데이터 집합에서 레코드를 변경하면 원래 값(데이터 소스에서 읽은 값)과 현재 값(변경 후의 값)을 포함한 여러 레코드 복사본을 사용할 수 있습니다. 매개 변수로서 전달할 열 값을 지정할 때 두 값 중 전달할 값을 선택합니다. 일반적으로 원래 값은 데이터베이스의 레코드를 식별하기 위해 WHERE 절에서 매개 변수로 사용되며 현재 값은 SET 또는 VALUES 절에서 사용됩니다.

  • Value 속성. 이 속성은 매개 변수로 전달되는 명시적인 리터럴 값입니다. 이 속성을 설정하면 SourceColumn 속성이 재정의되므로 두 속성은 함께 사용할 수 없습니다.

사용자 인터페이스 요소 목록

  • Add
    컬렉션에 새 매개 변수를 만듭니다. 기본적으로 테이블 이름은 Parametern으로 지정됩니다. 여기서 n은 일련 번호입니다. 속성 표 형태 창에서 ParameterName 속성을 설정하여 테이블의 이름을 바꿀 수 있습니다.

    참고

    OleDbParameter 컬렉션 편집기는 명령에 대한 매개 변수의 개수와 형식이 올바른지 확인하지 않습니다.

    매개 변수는 문이나 명령에서 위치를 기준으로 매개 변수 자리 표시자에 대응됩니다. 따라서 컬렉션에서 매개 변수의 순서를 올바르게 지정해야 합니다.

  • Remove
    선택한 매개 변수를 컬렉션에서 삭제합니다.

참고 항목

참조

SqlParameter

개념

Visual Studio에서 데이터에 Windows Forms 컨트롤 바인딩

Visual Studio에서 데이터에 컨트롤 바인딩

기타 리소스

TableAdapter

Visual Studio에서 데이터에 연결

데이터를 받기 위해 응용 프로그램 준비

데이터를 응용 프로그램으로 페치

응용 프로그램에서 데이터 편집

데이터 유효성 검사

데이터 저장