TableAdapter 쿼리 구성 마법사

아티클
08/09/2011

TableAdapter 쿼리 구성 마법사에서는 TableAdapter에 추가할 수 있는 쿼리를 만들고 편집할 수 있습니다. TableAdapter 쿼리는 TableAdapter의 관련 데이터 테이블과 동일한 스키마에 맞는 데이터를 반환하거나 스칼라 값을 반환하는 저장 프로시저나 유효한 SQL 쿼리입니다. 마법사를 완료하면 호출될 때 해당 쿼리를 실행하는 메서드가 TableAdapter에 추가됩니다. 예를 들어, CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle")입니다.

마법사 실행

데이터 집합 디자이너로 쿼리를 끌어 오거나 기존 쿼리(첫 번째 쿼리 아래에 나열된 쿼리)를 구성합니다.

TableAdapter의 첫 번째 쿼리는 TableAdapter의 주 쿼리입니다. 이 주 쿼리를 편집하면 TableAdapter 구성 마법사가 열리고 TableAdapter의 데이터 테이블 스키마가 편집됩니다. 주 쿼리 아래에 나열된 모든 쿼리는 추가 쿼리이며 TableAdapter 쿼리 구성 마법사를 사용하여 구성할 수 있습니다. 마법사 실행에 대한 자세한 내용은 방법: TableAdapter 쿼리 구성 마법사 시작을 참조하십시오.

데이터 연결 선택

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

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

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

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

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

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

SQL 문 사용

이 단원에서는 SQL 문 사용 옵션을 선택할 경우 TableAdapter 쿼리 구성 마법사를 완료하는 방법에 대해 설명합니다.

쿼리 형식 선택

마법사에서는 응용 프로그램의 요구 사항에 따라 여러 형식의 쿼리를 만듭니다. 데이터 행(데이터 테이블)을 반환하는 SELECT 쿼리나 스칼라 값(Count 또는 Sum 같은 단일 값)을 반환하는 SELECT 쿼리를 선택할 수 있습니다.

쿼리 형식 선택 페이지의 사용할 수 있는 쿼리 목록에서 만들 쿼리 형식을 선택합니다.

참고

INSERT, UPDATE 또는 DELETE 문을 만들어도 TableAdapter의 Update 메서드를 호출할 때 사용되는 TableAdapter의 명령은 바뀌지 않습니다. 예를 들어, UPDATE를 쿼리 형식으로 선택하면 마법사의 뒷부분에서 지정하는 이름의 새 쿼리가 만들어집니다. 이 쿼리를 실행하려면 이 이름이 지정된 TableAdapter 메서드를 호출해야 합니다. TableAdapter의 Update 메서드를 호출하면 원래 TableAdapter가 구성될 때 만들어진 문이 실행됩니다.

SQL <Query Type> 문을 지정하십시오.

SQL 문을 지정하십시오. 페이지에서, 해당 쿼리를 호출할 경우 실행할 SQL 문을 입력합니다.

팁

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

생성할 메서드 선택

이 페이지에서는 마법사가 쿼리에 대해 생성할 메서드를 선택할 수 있는 옵션을 제공합니다.

DataTable 채우기
데이터 테이블을 채울 메서드를 만듭니다. 데이터 테이블을 반환된 데이터로 채우려면 이 메서드를 호출할 때 데이터 테이블의 이름을 매개 변수로 전달해야 합니다.

선택에 따라 메서드 이름 상자의 기본 이름을 변경할 수 있습니다. 의미 있는 이름을 제공하면 코드에서 이 쿼리를 사용할 때 도움이 될 수 있습니다.
DataTable 반환
채워진 데이터 테이블을 반환하는 메서드를 만듭니다. 일부 응용 프로그램에서는 기존 데이터 테이블을 데이터로 채우는 것보다 채워진 데이터 테이블을 반환하는 것이 더 나을 수 있습니다.

선택에 따라 메서드 이름 상자의 기본 이름을 변경할 수 있습니다.

함수 이름을 선택하십시오.

함수의 이름을 입력합니다. TableAdapter 쿼리를 만들면 메서드가 여기에 입력한 이름으로 TableAdapter에 추가됩니다. 쿼리를 실행하려면 이 메서드를 호출합니다. 의미 있는 이름을 제공하면 코드에서 이 쿼리를 사용할 때 도움이 됩니다.

참고

새 저장 프로시저를 만들 때 두 가지 이름을 지정해야 합니다. 첫 번째 이름은 데이터베이스에 만들어지는 저장 프로시저의 이름이고 두 번째 이름은 호출될 경우 저장 프로시저를 실행하는 TableAdapter의 메서드 이름입니다.

새 저장 프로시저 만들기

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

저장 프로시저 생성 페이지에서 저장 프로시저를 호출할 경우 실행할 SQL 문을 입력합니다.

참고

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

기존 저장 프로시저 사용

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

마법사의 기존 저장 프로시저를 선택하십시오. 페이지에 있는 드롭다운 목록에서 기존 저장 프로시저를 선택합니다.

선택한 저장 프로시저의 매개 변수 및 결과가 참조용으로 표시됩니다.
다음을 클릭합니다.

저장 프로시저에서 반환된 데이터의 형식을 선택하십시오.

선택한 저장 프로시저에서 반환된 데이터 형식에 의해 마법사에서 TableAdapter 메서드를 만드는 방법이 결정됩니다.

이 쿼리에서 반환되는 데이터 형식을 선택합니다.

표 형식 데이터를 선택하면 생성할 메서드 선택 페이지(이 도움말 페이지의 앞 부분에서 설명함)가 열립니다. 여기서 만들 메서드 형식, 메서드 이름 및 페이징 기능을 지정할 수 있습니다.
단일 값을 선택하면 단일 값을 반환하는 형식화된 메서드가 만들어집니다. 이 옵션을 사용하면 함수 이름을 선택하십시오. 페이지(이 도움말 페이지의 앞 부분에서 설명함)가 열립니다.
값 없음을 선택하면 저장 프로시저를 실행하고 데이터를 반환 받지 않는 형식화된 메서드가 만들어집니다. 이 옵션을 사용하면 함수 이름을 선택하십시오. 페이지(이 도움말 페이지의 앞 부분에서 설명함)가 열립니다.

마법사 결과 보기

마법사 결과 보기 페이지에서는 TableAdapter 쿼리 만들기의 결과를 보여 줍니다. 마법사에서 문제가 발생하는 경우에는 이 페이지에 세부 사항이 표시됩니다.

참고 항목