다음을 통해 공유


TableAdapter 구성 마법사

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

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

마법사 실행

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

데이터 연결 선택

연결 목록에서 기존 연결을 선택하거나 새 연결을 클릭하여 데이터베이스에 대한 연결을 만듭니다.

연결 속성 대화 상자에서 작업을 완료하고 나면 연결 정보 영역에는 선택한 공급자에 대한 읽기 전용 정보와 연결 문자열이 표시됩니다.

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

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

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

보안 정보보안 정보

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

명령 유형 선택

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

명령 유형을 선택하십시오. 페이지에서 데이터베이스에서 데이터를 가져오는 다음 방법 중 하나를 선택합니다.

  • SQL 문 사용: 데이터베이스에서 데이터를 선택하는 SQL 문을 입력할 수 있습니다.

  • 새 저장 프로시저 만들기: 지정한 SELECT 문을 기준으로 마법사가 데이터베이스에 새 저장 프로시저를 만들도록 하려면 이 옵션을 선택합니다.

  • 기존 저장 프로시저 사용: 데이터베이스에 이미 있는 저장 프로시저를 TableAdapter의 SELECT, INSERT, UPDATE 및 DELETE 명령에 매핑하려면 이 옵션을 선택합니다.

SQL 문 사용

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

SQL 문 생성 페이지에서 실행하는 경우 데이터 테이블에 데이터를 채우는 SQL 문을 입력합니다.

마법사 결과 보기 페이지에는 TableAdapter 만들기 결과가 표시됩니다. 마법사에 문제가 발생하는 경우 이 페이지에서 오류 정보가 제공됩니다.

생성할 메서드 선택

이 페이지에서는 데이터를 가져오고 업데이트하기 위해 마법사에서 생성할 TableAdapter 메서드 선택 옵션이 제공됩니다.

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

    원하는 경우 메서드 이름 상자의 기본 이름을 변경할 수 있습니다.

  • DataTable 반환
    채워진 데이터 테이블을 반환할 TableAdapter의 메서드를 만듭니다. 특정 응용 프로그램에서는 기존 데이터 테이블에 데이터를 채우는 것보다 채워진 데이터 테이블을 반환하는 것이 더 효율적일 수 있습니다.

    원하는 경우 메서드 이름 상자의 기본 이름을 변경할 수 있습니다.

  • 업데이트를 데이터베이스로 직접 보내는 메서드 만들기
    변경 내용을 기본 데이터베이스에 기록하는 데 필요한 INSERT, UPDATE 및 DELETE 명령을 만듭니다. 이 확인란을 선택하는 것은 GenerateDBDirectMethods 속성을 true로 설정하는 것과 같습니다.

    참고

    원래 SQL 문에서 충분한 정보를 제공하지 않거나 쿼리가 업데이트할 수 없는 쿼리인 경우에는 이 옵션을 사용할 수 없습니다.예를 들어 JOIN 쿼리 또는 단일 값(스칼라)을 반환하는 쿼리에서 이러한 현상이 발생할 수 있습니다.

새 저장 프로시저 만들기

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

  1. 저장 프로시저 생성 페이지에서 데이터 테이블을 채우는 SQL 문을 입력합니다. 이 문은 TableAdapter의 SELECT 문이며, 데이터 선택/업데이트/삽입/삭제용 저장 프로시저를 만드는 기준으로 사용됩니다.

  2. 저장 프로시저 만들기 페이지에서 다음을 수행합니다.

    1. 새 저장 프로시저의 이름을 입력합니다.

    2. 기본 데이터베이스에서 저장 프로시저를 만들지 여부를 지정합니다.

      참고

      특정 데이터베이스의 보안 설정 및 사용 권한에 따라 해당 데이터베이스에서 저장 프로시저를 만들 수 있는지 여부가 결정됩니다.예를 들어 데이터베이스에서 새 저장 프로시저를 만들 권한이 없으면 이 옵션을 완료할 수 없습니다.

    마법사 결과 보기 페이지에는 TableAdapter 만들기 결과가 표시됩니다. 마법사에 문제가 발생하는 경우 이 페이지에서 오류 정보가 제공됩니다.

기존 저장 프로시저 사용

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

dex7k4dw.collapse_all(ko-kr,VS.140).gif기존 저장 프로시저에 명령 바인딩

TableAdapter의 SELECT, INSERT, UPDATEDELETE 명령에 대해 실행할 저장 프로시저를 선택합니다. TableAdapter에 대해 관련 메서드를 호출하면 이러한 저장 프로시저가 실행됩니다. 예를 들어 업데이트 명령에 할당된 저장 프로시저는 TableAdapter.Update() 메서드를 호출하면 실행됩니다.

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

참고

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

고급 옵션

고급 옵션을 클릭하면 다음과 같은 TableAdapter의 고급 옵션에 액세스할 수 있습니다.

  • Insert, Update 및 Delete 문 생성

    이 옵션을 선택하면 마법사가 SQL 문 생성 페이지에 정의된 SELECT 문을 기준으로 INSERT, UPDATE 및 DELETE 문 생성을 시도합니다.

  • 낙관적 동시성 사용

    이 옵션을 사용하면 데이터 테이블로 읽어들인 후 개별 레코드가 수정되었는지 여부를 검색하도록 UPDATE 및 DELETE 문을 수정합니다. 동시성 위반이 검색되면 예외가 throw됩니다.

  • DataTable 새로 고침

    이 옵션을 선택하면 INSERT 및 UPDATE 문이 실행된 후 테이블의 데이터를 새로 고칩니다.

다음 단계

마법사가 완료되면 TableAdapter가 데이터 집합에 추가되며 데이터 집합 디자이너에서 보고 편집할 수 있는 상태가 됩니다. 그러고 나면 다음과 같은 단계를 수행할 수 있습니다.

  • TableAdapter를 더 추가합니다. 마법사에서는 TableAdapter를 하나만 만듭니다. 여러 테이블이 포함된 데이터 집합을 사용하려는 경우 데이터 집합에 TableAdapter를 더 추가할 수 있습니다.

  • TableAdapter에 쿼리를 더 추가합니다. 자세한 내용은 방법: TableAdapter 쿼리 만들기을 참조하십시오.

  • 데이터 소스 창에 이 데이터 집합을 표시한 다음 폼으로 항목을 끌어 데이터 바인딩된 컨트롤을 만듭니다. 자세한 내용은 Visual Studio에서 데이터에 Windows Forms 컨트롤 바인딩을 참조하십시오.

참고 항목

작업

방법: TableAdapter 쿼리 만들기

방법: TableAdapter 쿼리 편집

방법: 데이터베이스의 데이터에 연결

연습: Windows Form에 데이터 표시

참조

TableAdapter 쿼리 구성 마법사

개념

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

형식화된 데이터 집합 만들기 및 편집

데이터 소스 개요

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

데이터 유효성 검사

기타 리소스

데이터 연습