자습서: 이산 매개 변수 읽기 및 설정
소개
이산 매개 변수는 특정 범위의 값을 가리키는 범위 매개 변수와 달리 하나의 값을 나타냅니다. 텍스트 항목(예: 도시)에는 일반적으로 이산 매개 변수를 통해 액세스하고, 숫자 항목(예: 직원 급여)에는 일반적으로 범위 매개 변수를 통해 액세스합니다.
이 자습서에서는 필드 하나를 기준으로 고객 보고서를 보기 위한 이산 매개 변수의 값을 설정합니다. 보고서에는 도시 목록에서 선택한 도시에 살고 있는 고객만 표시됩니다. 도시 목록은 도시 매개 변수의 기본값에서 파생됩니다. 이러한 도시 매개 변수의 기본값은 보고서에서 캡슐화됩니다.
먼저 도시 매개 변수를 사용하여 고객 보고서를 만듭니다. 보고서의 데이터는 Crystal Reports for Visual Studio와 함께 제공된 샘플 데이터베이스에서 가져옵니다. 코드에서 보고서를 인스턴스화할 때 도시 이름(Paris, Tokyo)이 포함된 ArrayList를 만들고 도시 이름을 도시 매개 변수의 현재 값으로 설정하는 도우미 메서드로 이 ArrayList 인스턴스를 전달합니다. 그런 다음 CrystalReportViewer 컨트롤에 보고서를 바인딩하면 파리와 도쿄에 사는 고객만 표시된 보고서를 볼 수 있습니다.
자습서의 다음 부분에서는 아래와 같은 작업을 수행합니다.
- 기본값을 모두 가져와 ArrayList에 반환하는 메서드를 만듭니다.
- 폼에 ListBox 컨트롤을 추가하고 ArrayList의 값으로 컨트롤을 채웁니다.
- Button 컨트롤을 추가하여 ListBox에서 선택한 항목에 따라 보고서를 다시 표시합니다.
자습서의 마지막 부분에서는 ListBox 컨트롤에서 선택한 항목을 검색하여 도시 매개 변수의 현재 값으로 설정하도록 단추 클릭 이벤트의 코드를 작성합니다. ListBox 컨트롤 내에서 선택한 도시에 살고 있는 고객만 표시되는 보고서가 다시 나타납니다.
CrystalReportViewer 개체 모델의 클래스를 사용하여 이 자습서의 내용을 진행할 수도 있지만 ReportDocument 개체 모델을 사용하는 것이 더 좋습니다. 어떠한 개체 모델을 사용할지에 대한 자세한 내용은 "개체 모델 선택"을 참조하십시오.
CrystalReportViewer 개체 모델을 사용하여 이 자습서의 내용을 진행하려면 "자습서: 보안 SQL Server 데이터베이스에 로그온"을 참조하십시오.
샘플 코드
이 자습서에는 완성된 프로젝트 버전을 보여 주는 Visual Basic 및 C# 샘플 코드가 함께 제공됩니다. 완성된 버전에서 작업하려면 이 자습서의 지침에 따라 새 프로젝트를 만들거나 샘플 코드 프로젝트를 여십시오.
샘플 코드는 언어와 프로젝트 형식에 따라 다른 폴더에 저장되어 있습니다. 샘플 코드 버전별 폴더 이름은 다음과 같습니다.
- C# 웹 사이트: CS_Web_RDObjMod_Parameters
- C# Windows 프로젝트: CS_Win_RDObjMod_Parameters
- Visual Basic 웹 사이트: VB_Web_RDObjMod_Parameters
- Visual Basic Windows 프로젝트: VB_Win_RDObjMod_Parameters
이러한 샘플이 포함된 폴더를 찾으려면 "자습서의 샘플 코드 디렉터리"를 참조하십시오.