포함된 보고서 및 드릴스루 보고서 구성(Visual Studio 보고서 디자이너)

아티클
08/22/2008

포함된 보고서와 드릴스루 보고서를 사용하여 관련 보고서를 연결할 수 있습니다.

포함된 보고서는 부모 보고서의 본문 내에 포함된 컨트롤입니다. 개념적으로 포함된 보고서는 다른 웹 페이지 콘텐츠의 컨테이너를 제공하는 웹 페이지의 프레임과 비슷하며 포함하는 부모 보고서 내부에 렌더링됩니다. 두 보고서는 동시에 처리되어 표시됩니다.
드릴스루 보고서는 보고서 항목에 설정된 드릴스루 동작의 결과로 열립니다. 이 동작은 일반적으로 부모 보고서와 같은 공간에 있는 매개 변수가 다른 동일한 보고서나 관련 보고서를 엽니다. 대개 드릴스루 보고서는 데이터를 통해 부모 보고서와 관련됩니다. 드릴스루 보고서의 일반적인 예로 월별 개인 판매 주문에 대한 링크가 포함된 월별 판매 보고서가 있을 수 있습니다. 드릴스루 링크를 클릭하면 부모 보고서가 지원 세부 정보를 제공하는 다른 보고서로 바뀝니다.

드릴스루 보고서와 포함된 보고서는 모두 부모 보고서와 자식 보고서의 개념을 지원합니다. 보고서를 연결하려면 관계 설정 데이터를 전달하는 데 사용할 수 있는 보고서 매개 변수를 만들어야 합니다. 런타임 시 보고서를 연결하려면 연결을 지원하는 코드를 작성해야 합니다. 관련 보고서를 배포할 때는 클라이언트 보고서 정의(.rdlc) 파일이 파일 시스템의 동일한 폴더에 함께 저장되어 있는지 확인합니다.

다음 이벤트에는 ReportViewer 컨트롤에 대해 포함된 보고서와 드릴스루 동작을 구현하는 방법을 보여 주는 예제 코드가 포함되어 있습니다.

드릴다운 대화형 작업을 보고서에 포함하는 방법은 방법: 보고서 항목 숨기기 또는 토글 표시 유형 정의(Visual Studio 보고서 디자이너)를 참조하십시오.

포함된 보고서 추가

포함된 보고서와 해당 부모 보고서는 공유 매개 변수를 통해 관련될 수 있습니다. 각 보고서에 매개 변수를 추가해야 합니다. 부모 보고서에 포함된 보고서를 추가하기 전에 매개 변수를 구성해야 합니다. 포함된 보고서를 추가할 때 부모 보고서에서 포함된 보고서로 매개 변수를 전달하도록 설정합니다.

포함된 보고서를 추가하려면

클라이언트 보고서 정의(.rdlc) 파일을 그래픽 디자인 모드로 엽니다.
도구 상자에서 포함된 보고서를 클릭합니다.
디자인 화면에서 상자를 끌어 포함된 보고서를 원하는 크기로 조절합니다. 또는 디자인 화면을 클릭하여 고정된 크기의 포함된 보고서를 만듭니다.

참고

포함된 보고서가 프로젝트에 있는 경우 솔루션 탐색기에서 디자인 화면으로 보고서를 끌어 와서 포함된 보고서를 만들 수 있습니다.
포함된 보고서를 마우스 오른쪽 단추로 클릭한 다음 속성을 클릭합니다.
포함된 보고서에서 포함된 보고서 영역에 표시할 보고서를 선택합니다.
매개 변수 탭에서 다음을 수행하십시오.
- 매개 변수 이름에 포함된 보고서에 있는 매개 변수의 이름을 입력합니다. 이 이름은 ReportName 속성에서 이름을 지정한 보고서의 보고서 매개 변수와 일치해야 합니다.
- 매개 변수 값에 포함된 보고서에 전달할 값을 입력합니다. 이 값은 정적 텍스트이거나 부모 보고서의 필드 또는 다른 개체를 가리키는 식일 수 있습니다.
포함된 보고서에 전달할 매개 변수를 추가하려면 2단계를 반복합니다.

참고
포함된 보고서가 프로젝트에 있는 경우 솔루션 탐색기에서 디자인 화면으로 보고서를 끌어 와서 포함된 보고서를 만들 수 있습니다.

참고
포함된 보고서에 필요한 모든 매개 변수를 매개 변수 목록에 포함시켜야 합니다. 필수 매개 변수가 없으면 포함된 보고서가 부모 보고서에서 올바르게 표시되지 않습니다.

포함된 보고서에 데이터를 제공하려면 응용 프로그램에서 LocalReport 개체의 SubreportProcessing 이벤트를 처리해야 합니다. SubreportProcessing 이벤트 처리기 메서드로 전달되는 인수 중 하나는 SubreportProcessingEventArgs입니다. 이벤트 처리기에서 응용 프로그램은 SubreportProcessingEventArgs의 Parameters 속성을 사용하여 포함된 보고서로 전달되는 매개 변수 값을 검사할 수 있습니다. 그런 다음 응용 프로그램은 SubreportProcessingEventArgs의 DataSources 속성을 사용하여 포함된 보고서에 데이터를 제공해야 합니다.

드릴스루 보고서 구성

부모 보고서에서 지원 데이터를 포함하는 보조 보고서로의 탐색을 제공하는 드릴스루 동작을 정의하여 드릴스루 보고서를 구성할 수 있습니다.

드릴스루 보고서는 일반적으로 부모 보고서에 의해 전달되는 매개 변수를 포함합니다. 판매 요약 보고서 예의 경우 드릴스루 보고서에 주문을 값으로 사용하는 매개 변수가 포함되어 있습니다. 요약 보고서에는 주문 번호별로 드릴스루 보고서 링크가 포함되어 있어 주문 ID를 클릭하여 전달하면 대상 세부 정보 보고서가 열립니다.

보고서 서버에 저장된 모든 보고서는 드릴스루 보고서가 될 수 있습니다. 텍스트 상자와 이미지에 대해서만 드릴스루 링크를 추가할 수 있습니다.

드릴스루 보고서 링크를 추가하려면

클라이언트 보고서 정의(.rdlc) 파일을 그래픽 디자인 모드로 엽니다.
링크를 추가할 텍스트 상자 또는 이미지를 마우스 오른쪽 단추로 클릭한 다음 속성을 클릭합니다.
탐색 탭에서 보고서로 이동을 선택합니다.
보고서 이름을 입력하거나 선택합니다. 보고서는 동일한 프로젝트에 포함된 .rdlc 파일이어야 합니다.

드릴스루 보고서에 전달할 매개 변수를 설정하려면 매개 변수를 클릭한 후 다음을 수행하십시오.

매개 변수 이름에 드릴스루 보고서에 있는 보고서 매개 변수의 이름을 입력합니다.

참고
매개 변수 목록에 있는 이름이 대상 보고서의 예상 매개 변수와 정확히 일치해야 합니다. 이름이 일치하지 않거나 예상 매개 변수가 목록에 없는 경우 드릴스루 보고서가 실패합니다.

매개 변수 값에서 드릴스루 보고서의 매개 변수에 전달할 값을 입력하거나 선택합니다.

참고
보고서 매개 변수에 전달할 값을 반환하는 식을 값에 포함시킬 수 있습니다. 값 목록의 식에는 현재 보고서에 대한 필드 목록이 포함됩니다.

드릴스루 보고서에 데이터를 제공하려면 응용 프로그램에서 ReportViewer 개체의 Drillthrough 이벤트를 처리해야 합니다. Drillthrough 이벤트 처리기 메서드로 전달되는 인수 중 하나는 DrillthroughEventArgs입니다. DrillThroughEventArgs에는 드릴스루 보고서를 나타내는 Report 속성이 있습니다. 이벤트 처리기에서 호스트 응용 프로그램은 드릴스루 보고서에 대해 GetParameters() 메서드를 호출하여 드릴스루 보고서로 전달되는 매개 변수 값을 검사할 수 있습니다. 그런 다음 호스트 응용 프로그램은 드릴스루 보고서의 DataSources 속성을 사용하여 드릴스루 보고서에 데이터를 제공해야 합니다.

참고 항목

개념

보고서에서 보고서 매개 변수 정의(Visual Studio 보고서 디자이너)
보고서에 대화형 작업, 표시 유형 및 탐색 기능 추가(Visual Studio 보고서 디자이너)

다음을 통해 공유