ASP.NET 2.0에서 ReportViewer 컨트롤 사용

저자：Eve Cole 업데이트 시간：2009-07-01 16:43:40

이 기사의 번역: webabcd

소개하다

모든 데이터 기반 애플리케이션의 공통 요구 사항은 보고입니다. 그러나 ASP.NET 1.x에서는 이 매우 중요한 기능이 제공되지 않습니다. 그러나 다행히도 .NET 2.0과 함께 제공되는 ReportViewer 컨트롤은 보고서에 대한 기본 요구 사항 중 일부를 충족할 수 있습니다. 이 문서에서는 이 컨트롤을 사용하는 방법을 보여 드리겠습니다. ReportViewer 컨트롤은 웹 프로그램과 Windows 프로그램 모두에서 사용할 수 있습니다. 여기서는 웹 프로그램에서 사용하는 방법만 소개하겠습니다.

보고서 예시

우리는 아래와 같이 고객 정보 목록을 생성한다고 가정합니다.

위 보고서는 국가별로 그룹화된 고객 정보의 매우 간단한 목록입니다. 보고서의 데이터는 Northwind 데이터베이스의 Customers 테이블에서 가져옵니다. 기본적으로 모든 고객 정보가 표시됩니다. 그러나 지정한 국가에 속한 고객에 대한 정보를 표시하도록 할 수도 있습니다.

보고서는 강력한 형식의 DataSet 또는 사용자 지정 개체 컬렉션에서 데이터를 얻을 수 있는 ReportViewer 컨트롤을 사용하여 디자인되었습니다. 실제 프로그램 개발에서는 3계층 아키텍처를 사용하는 경우가 많으며, 얻은 데이터는 비즈니스 계층에서 얻은 DataSet 또는 일반 컬렉션인 경우가 많습니다. 여기서는 강력한 형식의 DataSet 대신 일반 컬렉션을 데이터 소스로 사용할 계획입니다.

클래스 라이브러리 만들기

먼저 Visual Studio를 열고 ReportViewerLib라는 클래스 라이브러리 프로젝트를 만듭니다. 아래와 같이 Customer라는 클래스를 추가합니다.

시스템 사용;
System.Data 사용;
System.Configuration 사용;
System.Data.SqlClient 사용;
System.Collections.Generic을 사용합니다.
네임스페이스 ReportViewerLib
{
공개 수업고객
{
공개 문자열 strCustomerID;
공개 문자열 strCompanyName;
공개 문자열 strContactName;
공개 문자열 strCountry;

공개 문자열 CustomerID
{
얻다
{
strCustomerID를 반환합니다.
}
세트
{
strCustomerID = 값;
}
}

공개 문자열 회사 이름
{
얻다
{
strCompanyName을 반환합니다.
}
세트
{
str회사이름=값;
}
}

공개 문자열 연락처 이름
{
얻다
{
strContactName을 반환합니다.
}
세트
{
strContactName=값;
}
}

공개 문자열 국가
{
얻다
{
strCountry를 반환합니다.
}
세트
{
str국가=값;
}
}

공개 정적 목록

GetCustomersForCountry(문자열 국가)
{
SqlConnection cnn=새 SqlConnection(
ConfigurationManager.ConnectionStrings["NorthwindConnectionString"].ConnectionString);
SqlCommand cmd=새 SqlCommand();
cmd.연결=cnn;
cmd.CommandText="선택
고객 ID, 회사 이름, 연락처 이름, 국가
country=@country";인 고객의 경우
SqlParameter p=새 SqlParameter
("@국가",국가);
cmd.Parameters.Add(p);
cnn.Open();
SqlDataReader 리더 = cmd.ExecuteReader();
목록

목록 = 새 목록

();
동안(reader.Read())
{
고객 c = 신규 고객();
c.CustomerID = reader.GetString(0);
c.CompanyName = reader.GetString(1);
c.연락처 이름 = reader.GetString(2);
c.국가 = reader.GetString(3);
목록.추가(c);
}
cnn.닫기();
반환 목록;
}

공개 정적 목록

모든고객얻기()
{
SqlConnection cnn = 새 SqlConnection(
ConfigurationManager.ConnectionStrings
["NorthwindConnectionString"].ConnectionString);
SqlCommand cmd = 새로운 SqlCommand();
cmd.연결 = cnn;
cmd.CommandText = "선택
고객의 고객 ID, 회사 이름, 연락처 이름, 국가";
cnn.Open();
SqlDataReader 리더 = cmd.ExecuteReader();
목록

목록 = 새 목록

Customer 클래스는 CustomerID, CompanyName, ContactName 및 Country라는 네 가지 공용 속성을 정의합니다. 그 다음에는 이 클래스에 GetCustomersForContry() 및 GetAllCustomers()라는 두 가지 정적 메서드가 포함되어 있습니다. 이 두 가지 방법은 비교적 간단합니다. 하나는 특정 국가에 속한 모든 고객 정보를 반환하고 다른 하나는 모든 고객 정보를 반환합니다. 먼저 Northwind 데이터베이스에 대한 연결을 연 다음 SqlCommand 개체를 통해 SELECT 쿼리를 실행합니다. 그런 다음 SqlDataReader 개체를 사용하여 데이터를 가져옵니다. 이 SqlDataReader 개체를 탐색하고 그 안에 매번 Customer 개체를 만든 다음 다양한 속성을 설정하고 마지막으로 Customer 개체의 일반 컬렉션에 추가합니다. 클래스가 끝나면 Customer 개체의 일반 컬렉션이 호출자에게 반환됩니다.
데이터 소스 만들기

보고서를 디자인할 때 프로젝트에서 보고서에 대한 데이터 소스를 지정해야 합니다. 프로젝트에 데이터 소스를 추가하려면 데이터 메뉴 -> 새 데이터 소스 추가를 선택하면 됩니다. 그러면 아래와 같은 대화 상자가 나타납니다.

데이터 소스는 데이터베이스, 웹 서비스 또는 개체일 수 있습니다. 이 경우에는 개체를 선택했습니다. 그런 다음 "다음" 버튼을 클릭하면 데이터 소스를 선택할 수 있는 인터페이스가 나타납니다. 우리는 Customer 클래스를 선택했습니다(아래 그림 참조).

데이터 소스 구성 마법사를 완료하려면 "마침" 버튼을 클릭하세요. 이런 방식으로 클래스 라이브러리에 새 데이터 소스를 추가했습니다. 데이터 소스를 보려면 "데이터" 메뉴 -> 데이터 소스 표시를 선택하면 아래와 같은 인터페이스가 나타납니다.

디자인 보고서

다음으로 보고서를 추가합니다. 프로젝트를 마우스 오른쪽 버튼으로 클릭하고 "새 항목 추가"를 선택합니다. 대화 상자에서 "보고서"를 선택하고 "추가" 버튼을 클릭합니다(아래 그림 참조). 이런 방식으로 "Report1.rdlc"라는 파일을 추가했습니다. .rdlc 파일은 보고서 레이아웃과 데이터 매핑을 저장하는 보고서 파일입니다.

Report1.rdlc 파일을 열면 Visual Studio 도구 상자에 보고서 관련 컨트롤 집합이 표시됩니다(아래 참조).

이러한 컨트롤 중에서 "텍스트 상자" 컨트롤과 "테이블" 컨트롤이 매우 일반적으로 사용됩니다. "텍스트 상자" 컨트롤은 정적 텍스트나 표현식을 표시하는 데 사용됩니다. "테이블" 컨트롤은 표 형식의 데이터를 표시하는 데 사용되며, 이에 의해 생성된 결과는 보고서의 "본문"에 표시됩니다.

디자인된 보고서는 다음과 같습니다.

보고서의 "머리글" 섹션 머리 부분에는 값 속성이 "고객 목록"인 텍스트 상자가 있습니다. 이 텍스트 상자 아래에는 또 다른 텍스트 상자가 있으며 해당 Value 속성의 값은 "=Parameters!SubTitle.Value"입니다. 이는 텍스트 상자의 값이 SubTitle이라는 매개변수에서 나온다는 것을 의미합니다. 매개변수를 어떻게 정의합니까? 이를 위해서는 보고서의 ReportParameters 속성에 매개변수를 추가해야 합니다. 열린 보고서 매개변수 대화 상자는 아래 그림과 같습니다.

참고: 매개변수 설정은 .NET 코드에서 수행됩니다.

보고서에 날짜를 표시하려면 해당 텍스트 상자의 Value 속성을 "=FormatDateTime(ToDay(),DateFormat.ShortDate)"로 설정하면 됩니다. 보고서의 가장 큰 장점 중 하나는 ToDay() 및 FormatDateTime과 같은 기본 제공 함수가 많다는 것입니다. 이 예에서는 FormatDateTime() 함수를 사용하여 현재 날짜(ToDay())를 ShortDate 형식으로 표시합니다.

이제 도구 상자의 "테이블" 컨트롤을 보고서로 끌어옵니다. 기본적으로 "테이블" 컨트롤에는 3개의 행과 3개의 열이 있습니다. 3개 행은 테이블 머리글, 세부 정보 및 테이블 바닥글입니다. 물론 Table 컨트롤에 행과 열을 추가할 수도 있습니다. 데이터 원본 창에서 CustomerID, CompanyName, ContactName 및 Country 속성을 테이블 컨트롤의 세부 정보 행으로 끌어 놓습니다. 이러한 방식으로 시스템은 자동으로 텍스트 상자를 추가하고 해당 속성을 =Fields!CustomerID.Value, =Fields!CompanyName.Value 등으로 설정합니다. 이 시점에서 열 헤더도 자동으로 추가됩니다. 물론 필요에 따라 필요한 수정을 할 수도 있습니다.

다음으로 고객이 속한 국가별로 레코드를 그룹화하려고 합니다. 세부 정보 행의 테두리를 마우스 오른쪽 버튼으로 클릭하고 그룹 삽입을 선택합니다(아래 이미지 참조).

그러면 아래와 같은 대화 상자가 나타납니다.

"정렬" 탭에서 표현식으로 "=Fields!Country.Value"를 선택하고 정렬 방향으로 "오름차순"을 선택합니다.

그것들은 매우 간단합니다. 이로써 보고서 디자인이 완성되었습니다.
보고서 표시

"ReportViewerDemo"라는 새 웹 사이트를 만듭니다. 어셈블리가 웹 사이트의 BIN 디렉터리에 복사되도록 ReportViewerLib 어셈블리에 대한 참조를 추가합니다. 그런 다음 Report1.rdlc 파일을 웹 사이트에 추가하십시오. 도구 상자의 "데이터" 탭에 있는 ReportViewer 컨트롤을 Default.aspx 페이지로 끌어서 ReportViewer 컨트롤의 스마트 태그 패널을 열고 "보고서 선택" 드롭다운 상자에서 Report1.rdlc를 선택합니다. 아래 그림 :

보고서 파일을 선택한 후 시스템은 TypeName 속성이 Customer인 개체 데이터 소스 컨트롤을 자동으로 추가합니다. 개체 데이터 소스 제어의 구성 마법사에서 이를 확인할 수 있습니다.

그런 다음 DropDownList 컨트롤을 페이지 헤더로 끌어서 전체, 미국, 영국 및 브라질의 네 가지 옵션을 설정합니다. 또한 AutoPostBack 속성을 True로 설정합니다. 그런 다음 데이터 소스 제어의 구성 마법사를 열고 "SELECT" 작업을 SelectCustomersForCountry() 메서드로 설정합니다.

SelectCustomersForCountry() 메서드의 국가 매개 변수를 DropDownList1의 SelectedValue로 설정합니다.

기본적으로 모든 고객 정보가 보고서에 표시됩니다. DropDownList에서 국가를 선택하면 선택한 국가에 속한 고객 정보가 보고서에 표시됩니다. 이러한 기능을 완료하려면 DropDownList의 SelectedIndexChanged 이벤트만 처리하면 됩니다.

보호된 무효 DropDownList1_SelectedIndexChanged
(객체 발신자, EventArgs e)
{
if (DropDownList1.SelectedValue == "모두")
{
ObjectDataSource1.SelectMethod = "GetAllCustomers";
ObjectDataSource1.SelectParameters.Clear();
ReportParameter 매개변수 = 새 ReportParameter
("SubTitle", "전체 고객 목록");
ReportParameter[] p ={ param };
ReportViewer1.LocalReport.SetParameters(p);
}
또 다른
{
ObjectDataSource1.SelectMethod = "GetCustomersForCountry";
ObjectDataSource1.SelectParameters[0].DefaultValue
= DropDownList1.SelectedValue;

ReportParameter 매개변수 = 새 ReportParameter
("부제목", "국가별 고객 목록");
ReportParameter[] p ={ param };
ReportViewer1.LocalReport.SetParameters(p);
}
}

이 코드는 먼저 DropDownList 컨트롤의 SelectedValue 속성을 확인합니다. "All"인 경우 데이터 소스 컨트롤의 SelectMethod 속성을 GetAllCustomers로 설정합니다. 또한 GetAllCustomers() 메서드에는 매개 변수가 필요하지 않으므로 SelectParameters 컬렉션도 지워야 합니다. 다음으로 ReportParameter 클래스의 인스턴스를 만들고 생성자에서 보고서의 매개 변수 이름과 값을 설정합니다. 보고서를 디자인할 때 정의한 매개변수를 기억해 보세요. 그런 다음 ReportParameter 배열을 만듭니다. 이 배열을 매개변수로 사용하여 SetParameters() 메서드를 호출합니다. "else" 코드 블록도 매우 간단합니다. 즉, 사용된 메서드가 GetCustomersForCountry()가 됩니다.

그것들은 매우 간단합니다. 보고서가 완료되었습니다. Default.aspx 페이지를 실행하여 효과를 확인할 수 있습니다. ReportViewer 컨트롤에는 보고서를 Excel 또는 PDF 형식으로 내보낼 수 있는 내보내기 기능이 내장되어 있습니다. ReportViewer 컨트롤에도 많은 속성이 있으므로 직접 탐색할 수 있습니다.

요약

ASP.NET의 ReportViewer 컨트롤은 보고서의 다양한 기본 기능을 제공합니다. 이 문서에서는 개체 데이터 소스 컨트롤을 사용하여 보고서를 개발합니다. 클래스 라이브러리와 데이터 소스를 만들었습니다. 마지막으로 ReportViewer 컨트롤을 사용하여 보고서를 표시합니다.