TableAdapter 쿼리 구성 마법사

아티클
06/10/2015

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 <쿼리 형식> 문 지정

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

팁

마법사에서는 SQL 쿼리 작성을 위한 시각적 도구인 쿼리 작성기에 액세스할 수 있습니다.이 도구를 열려면 쿼리 작성기 단추를 클릭합니다.

생성할 메서드 선택

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

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

원하는 경우 메서드 이름 상자의 기본 이름을 변경할 수 있습니다. 의미 있는 이름을 지정하면 코드에서 이 쿼리를 사용할 때 도움이 될 수 있습니다.
DataTable 반환
채워진 데이터 테이블을 반환하기 위한 메서드를 만듭니다. 특정 응용 프로그램에서는 기존 데이터 테이블에 데이터를 채우는 것보다 채워진 데이터 테이블을 반환하는 것이 더 효율적일 수 있습니다.

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

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

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

참고

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

새 저장 프로시저 만들기

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

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

참고

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

기존 저장 프로시저 사용

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

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

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

저장 프로시저가 반환하는 데이터의 모양 선택

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

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

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

마법사 결과 보기

마법사 결과 보기 페이지에는 TableAdapter 쿼리 만들기 결과가 표시됩니다. 마법사에 문제가 발생하면 이 페이지에 세부 정보가 표시됩니다.

참고 항목

다음을 통해 공유