Crystal Reports

There have been many enquiries about Crystal Reports on the site and unfortunately there
are not too many technical articles and source code samples available on Crystal Reports on
C# Corner or any where else. As usual, I decided to dedicate some time to Crystal Reports
and fill the Crystal Reports section of C# Corner and VB.NET Heaven sites. As a result, in
next couple of weeks you will see some Crystal Reports articles from me. Hopefully, you will
enjoy these articles. Again, I encourage you to share your knowledge with other developers
to make our lives easier.
Unlike previous versions of Visual Studio, Crystal Reports is an integral part of Visual
Studio .NET and ships as a part of it. By making Crystal Reports a part of Visual Studio .NET
suite, Microsoft has added one more useful tool to the Visual Studio family. In this article, I
will show you how to create a simple report using Crystal Reports and Visual Studio .NET. In
my following article, I shall dig more into Crystal Reports .NET.
To follow this article, first create a Windows application by selecting File->New->Project>Visual C# Projects->Windows Application template from Visual Studio .NET project
templates. I give my project name IntroToCR.
Adding a Report to a Project
Crystal Report is a part of Add New Item templates available in Visual Studio. To add a
report to the project, add a new item by Right Clicking on the project in Solution Explorer
and selecting Add->Add New Item->Crystal Report as you can see in Figure 1. I change the
name of the report to Customers because we will be displaying customers related
information from Northwind database.
Now click the Open button.

Figure 1. Adding a Report to the Project

The next step is to select the report document type from Crystal Report Gallery. As you can
see from Figure 2, Crystal Report Gallery provides three options Using the Report Expert, As
a Blank Report, or From an Existing Report.
For our first application, lets keep all options as default. I will be discussing rest of the
options in my following articles.

Figure 2. Selecting a report type.

By clicking the OK button adds Customers.rpt file to the project and launches Standard
Report Expert wizard as you can see in Figure 3, where you can select a data source. The
Standard Report Expert wizard has 8 different tabs. I will discuss these tabs in more details
in my following articles. The main purpose of this article is to show you how to create your
first report in a few simple and quick steps.

Figure 3. Standard Report Expert wizard

Adding a Data Source
Now our next step is to link a data source to the wizard. There are different ways to link a
data source to the wizard. The simplest way is to click on the OLE DB(ADO) tree item in
Figure 3.
Clicking on OLE DB(ADO) item launches OLE DB Provider dialog where you can select a data
source as you can see in Figure 4.

Figure 4. OLE DB Provider dialog

Now on the OLE DB Provider, you can select a provider. I select Microsoft OLE DB Provider
for SQL Server. If you do not have access to SQL Server, you can select Access or other data
providers.
After select Microsoft OLD DB Provider for SQL Server, you will see the Next button is
activated on the wizard.
The Next button allows you to provide the connection information about a data source. As
you can see in Figure 5, we select Northwind database.

Figure 5. Connection Information dialog

Now you can click the Finish button.
This option adds the Northwind database to the list and if you expand the database item,
you will see the database tables.
Now on this page, I select Customers table and add it by clicking Insert Table button. Now
you can see the table listed in the right list box. See Figure 6.

Figure 6. Northwind database tables

Now click on Next button which moves to the Fields tab. On this page, you can select what
field you want to use in the report. For simplicity, I add only 5 columns to the report
CustomerId, CompanyName, ContactName, ContactTitle, and City. See Figure 7. On this
page, you can change the heading of a column by selecting a column and changing its name
in the Column Heading text box.

Figure 7. Adding columns to report

Now we can continue through different pages but we will stop here. Click Finish here. This
option adds the report with all columns to the project. The final report file looks like Figure
8.

Figure 8. Customers.rpt

Adding a Crystal Report Viewer Control

Now our next step is to add Customers.rpt to the Form. For this, we need to make sure the
size of the Form is big enough to fit the report. So you may want to go ahead and modify
the size of Form.
After resizing the Form, we need to add Crystal Report Viewer from Toolbox to the Form.
Simply drag the Crystal Report Viewer control from Toolbox to the Form and resize it
accordingly. My final Form looks like Figure 9.

Figure 9. Form with Crystal Report Viewer

Attaching Report to Crystal Report Viewer Control
The last step is to attach Customers.rpt to Crystal Report Viewer control. For this, we need
to set the ReportSource property of Crystal Report Viewer control. On the Forms load event
handler, we create an Instance of Customers class, and set it as the ReportSource property
of Crystal Report Viewer control.
Just write the following two bold lines on your Forms load event handler.
private void Form1_Load(object sender, System.EventArgs e)
{
Customers custReport = new Customers();
crystalReportViewer1.ReportSource = custReport;
}

Now compile and run the project. The output looks like Figure 10. Now you can see the
report with data. With the help of Crystal Report Viewer, you can select from various options
such as zoom in, zoom out, print, move next, move last, move previous, and move first.

Figure 10. The final report

Conclusion
By adding Crystal Report support to Visual Studio .NET, Microsoft had made developers like
easier. In this article, we saw how easy it is to generate a report from a SQL Server
database using Crystal Report available in Visual Studio 2003.
In my next articles in this series, I will be exploring more options of Crystal Reports.
Note: To run the attached source code, you MUST change the database information.