TableAdapter 구성 마법사

아티클
08/09/2011

TableAdapter 구성 마법사에서 TableAdapter를 만들고 편집합니다. 마법사에서는 사용자가 입력한 SQL 문 또는 데이터베이스의 기존 저장 프로시저를 기반으로 TableAdapter를 만듭니다. 또한 사용자가 마법사에 입력한 SQL 문을 기반으로 데이터베이스에 새 저장 프로시저를 만들 수도 있습니다.

TableAdapter는 데이터베이스에 연결하여 데이터베이스에 대해 쿼리 또는 저장 프로시저를 실행한 다음, 쿼리나 저장 프로시저에서 반환된 데이터를 DataTable에 채웁니다. 기존 데이터 테이블에 데이터를 채우는 것 이외에도 TableAdapter는 데이터로 채워진 새 데이터 테이블을 반환할 수 있습니다. 자세한 내용은 TableAdapter 개요을 참조하십시오.

마법사 실행

마법사를 실행하여 TableAdapter 및 관련 DataTable을 만들거나 편집할 수 있습니다. 자세한 내용은 방법: TableAdapter 구성 마법사 시작을 참조하십시오.

데이터 연결 선택

연결 목록에서 기존 연결을 선택하거나 새 연결을 클릭하여 연결 추가/수정 대화 상자(일반)를 열고 데이터베이스에 대한 연결을 만듭니다.

연결 속성 대화 상자를 완료하면 연결 정보 영역에 연결 문자열 및 선택한 공급자에 대한 읽기 전용 정보가 표시됩니다.

응용 프로그램 구성 파일에 연결 문자열 저장

응용 프로그램 구성 파일에 연결 문자열을 저장하려면 **예, 다음으로 연결을 저장합니다.**를 선택합니다. 연결 이름을 입력하거나 제공된 기본 이름을 사용합니다.

응용 프로그램 구성 파일에 연결 문자열을 저장하면 데이터베이스 연결이 변경될 경우에도 응용 프로그램을 쉽게 유지 관리할 수 있습니다. 데이터베이스 연결이 변경되면 응용 프로그램 구성 파일에서 연결 문자열을 편집할 수 있습니다. 그러면 소스 코드를 편집하고 응용 프로그램을 다시 컴파일하지 않아도 됩니다. 응용 프로그램 구성 파일에서 연결 문자열을 편집하는 데 대한 자세한 내용은 방법: 연결 문자열 저장 및 편집을 참조하십시오.

보안 정보
연결 정보는 응용 프로그램 구성 파일에 일반 텍스트로 저장됩니다. 중요한 정보에 대한 무단 액세스를 방지하기 위해 데이터를 암호화할 수 있습니다. 자세한 내용은 데이터 암호화 및 해독을 참조하십시오.

명령 유형 선택

데이터베이스에 대해 실행할 명령의 유형을 선택합니다.

명령 유형을 선택하십시오. 페이지에서 다음 메서드 중 데이터베이스로부터 데이터를 페치하는 데 사용할 메서드를 선택합니다.

SQL 문 사용을 선택하면 데이터베이스에서 데이터를 선택할 SQL 문을 입력할 수 있습니다.
새 저장 프로시저 만들기: 이 옵션을 선택하면 지정한 SELECT 문을 기반으로 마법사가 데이터베이스에 새 저장 프로시저를 만듭니다.
기존 저장 프로시저 사용: 이 옵션을 선택하면 데이터베이스에 이미 있는 저장 프로시저가 TableAdapter의 INSERT, UPDATE 및 DELETE 명령에 매핑됩니다.

SQL 문 사용

이 단원에서는 SQL 문 사용 옵션을 선택했을 때 TableAdapter 구성 마법사를 완료하는 방법을 설명합니다.

SQL 문 생성 페이지에서 데이터 테이블에 데이터를 채울 SQL 문을 입력합니다.

참고

마법사를 사용하면 SQL 쿼리를 만들기 위한 시각적 도구인 쿼리 작성기에 액세스할 수 있습니다. 이 도구를 열려면 쿼리 작성기 단추를 클릭합니다. 쿼리 작성기 사용에 대한 자세한 내용은 쿼리 및 뷰 디자이너 도구를 참조하십시오.

마법사 결과 보기 페이지에서 TableAdapter을 만든 결과를 볼 수 있습니다. 마법사에서 문제가 발생한 경우에는 이 페이지에 오류 정보가 표시됩니다.

생성할 메서드 선택

이 페이지에서는 마법사가 데이터 페치 및 업데이트를 위해 생성하는 TableAdapter 메서드를 선택할 수 있는 옵션을 제공합니다.

DataTable 채우기
데이터 테이블을 채우기 위한 TableAdapter의 기본 메서드를 만듭니다. 이 메서드를 호출할 때에는 데이터 테이블의 이름을 매개 변수로 전달합니다.

선택에 따라 메서드 이름 상자의 기본 이름을 변경할 수 있습니다.
DataTable 반환
채워진 데이터 테이블을 반환하기 위한 TableAdapter의 메서드를 만듭니다. 일부 응용 프로그램에서는 기존 데이터 테이블을 데이터로 채우는 것보다 채워진 데이터 테이블을 반환하는 것이 더 나을 수 있습니다.

선택에 따라 메서드 이름 상자의 기본 이름을 변경할 수 있습니다.
업데이트를 데이터베이스로 직접 보내는 메서드 만들기
변경 내용을 내부 데이터베이스에 기록하는 데 필요한 INSERT, UPDATE 및 DELETE 명령을 만듭니다. 이 상자를 선택하는 것은 GenerateDBDirectMethods 속성을 true로 설정하는 것과 같습니다.

참고

이 옵션은 원래 SQL 문에 충분한 정보가 없거나 쿼리가 업데이트할 수 있는 쿼리가 아니면 사용할 수 없습니다. 예를 들어, JOIN 쿼리와 단일 값(스칼라)을 반환하는 쿼리에서 이런 상황이 발생할 수 있습니다.

새 저장 프로시저 만들기

이 단원에서는 새 저장 프로시저 만들기 옵션을 선택했을 때 TableAdapter 구성 마법사를 완료하는 방법을 설명합니다.

저장 프로시저 생성 페이지에서 데이터 테이블을 채우는 SQL 문을 입력합니다. 이 SQL 문은 TableAdapter의 SELECT 문이 되고 데이터를 선택, 업데이트, 삽입 및 삭제하는 저장 프로시저를 만드는 기반이 됩니다.

참고

마법사를 사용하면 SQL 쿼리를 만들기 위한 시각적 도구인 쿼리 작성기에 액세스할 수 있습니다. 이 도구를 열려면 쿼리 작성기 단추를 클릭합니다. 쿼리 작성기 사용에 대한 자세한 내용은 쿼리 및 뷰 디자이너 도구를 참조하거나 해당 대화 상자에서 F1 키를 누르십시오.
저장 프로시저 만들기 페이지에서 다음을 수행합니다.
1. 새 저장 프로시저의 이름을 입력합니다.
2. 내부 데이터베이스에 저장 프로시저를 만들지 여부를 지정합니다.
  
  참고
  
  저장 프로시저를 데이터베이스에 만들 수 있는지 여부는 해당 데이터베이스에 대한 권한과 보안 설정에 따라 달라집니다. 예를 들어, 데이터베이스에 새 저장 프로시저를 만들 수 있는 권한이 없으면 이 옵션을 완료할 수 없습니다.
마법사 결과 보기 페이지에서 TableAdapter을 만든 결과를 볼 수 있습니다. 마법사에서 문제가 발생한 경우에는 이 페이지에 오류 정보가 표시됩니다.

기존 저장 프로시저 사용

이 단원에서는 기존 저장 프로시저 사용 옵션을 선택했을 때 TableAdapter 구성 마법사를 완료하는 방법을 설명합니다.

기존 저장 프로시저에 명령 바인딩

TableAdapter의 SELECT, INSERT, UPDATE 및 DELETE 명령에 대해 실행할 저장 프로시저를 선택합니다. 이들 저장 프로시저는 TableAdapter에서 연결된 메서드를 호출했을 때 실행됩니다. 예를 들어, Update 명령에 할당된 저장 프로시저는 TableAdapter.Update() 메서드를 호출했을 때 실행됩니다.

선택한 저장 프로시저의 매개 변수를 데이터 테이블의 해당 열로 매핑합니다. 예를 들어, 저장 프로시저가 테이블의 CompanyName 열로 전달하는 @CompanyName이라는 매개 변수를 받는 경우 @CompanyName 매개 변수의 소스 열을 CompanyName으로 설정합니다.

참고

SELECT 명령에 할당된 저장 프로시저는 마법사의 다음 단계에서 이름을 지정하는 TableAdapter의 메서드를 호출하여 실행됩니다. 기본값은 Fill이므로 SELECT 프로시저를 실행하는 일반적인 코드는 TableAdapter.Fill(tableName)입니다. 기본값인 Fill을 다른 이름으로 변경하는 경우 Fill을 새 이름으로 바꾸고 "TableAdapter"를 TableAdapter의 실제 이름으로 바꿉니다(예: CustomersTableAdapter).

고급 옵션

고급 옵션을 클릭하면 다음과 같은 TableAdapter의 고급 옵션이 나타납니다. 자세한 내용은 고급 SQL 생성 옵션 대화 상자을 참조하십시오.

Insert, Update 및 Delete 문 생성

이 옵션을 선택하면 마법사는 SQL 문 생성 페이지에 정의된 SELECT 문을 기반으로 INSERT, UPDATE 및 DELETE 문을 생성합니다.
낙관적 동시성 사용

이 옵션을 선택하면 개별 레코드가 처음 데이터 테이블로 읽힌 이후 변경되었는지 여부를 감지하도록 UPDATE 및 DELETE 문이 수정됩니다. 동시성 위반이 발견되면 예외가 throw됩니다.
데이터 테이블 새로 고침

이 옵션을 선택하면 INSERT 및 UPDATE 문을 실행한 후 테이블의 데이터가 새로 고쳐집니다.

다음 단계

마법사가 끝나면 TableAdapter가 데이터 집합에 추가되고 데이터 집합 디자이너에서 보고 편집할 수 있게 됩니다. 이 작업 이후에도 많은 작업을 수행해야 합니다.

TableAdapter를 더 추가합니다. 마법사를 완료하면 하나의 TableAdapter가 만들어집니다. 여러 테이블로 구성된 데이터 집합을 사용하려면 데이터 집합에 TableAdapter를 더 추가해야 할 것입니다.
TableAdapter에 쿼리를 더 추가합니다. 자세한 내용은 방법: TableAdapter 쿼리 만들기을 참조하십시오.
데이터 소스 창에서 이 데이터 집합을 보고 항목을 폼으로 끌어 와서 데이터 바인딩된 컨트롤을 만듭니다. 자세한 내용은 Visual Studio에서 데이터에 Windows Forms 컨트롤 바인딩을 참조하십시오.

참고 항목