|
|
|
|
How to create local reports RDLC featuring barcode images in .NET Windows Forms
Prerequisites
- Neodynamic Barcode Professional 3.0 (or greater) for Windows Forms (WinControl)
- Microsoft .NET Framework 2.0 (or greater)
- Microsoft Visual Studio 2005 or Visual Studio 2005 Express Editions (Visual Basic 2005 Express, Visual C# 2005 Express, etc). NOTE: For Express Editions, installing the free add-in for ReportViewer is mandatory.
- Microsoft SQL Server 2005 (any version) with AdventureWorks Database sample installed
|
In the following Step-By-Step Guide we're going to create a local report (RDLC file) which features barcoding capabilities by using Barcode Professional for .NET Windows Forms.
Follow these steps:
- Open Visual Studio and create a new Windows Forms application naming it LocalReportWithBarcode.
- Report's Data Source settings
Data can be supplied to Local Reports either as custom Objects or as ADO.NET DataTables. In this guide we'll be exploring each data source scenario in details. So please choose the data source scenario you want to use first and then follow the steps for each of them:
Using ADO.NET DataTables as data source of my local report
Follow these steps:
- Add a new DataSet item to the project and name it AdventureWorks.xsd
Adding a Typed DataSet
- Add a new TableAdapter to the DataSet (Right-clicking on the DataSet design surface and selecting Add > TableAdapter... or by dragging & dropping a TableAdapter from the Toolbox).
Adding a TableAdapter to the AdventureWorks DataSet
Follow the wizard steps. In the first step, please create a connection to the AdventureWorks SQL Server Database sample and click Next. In the second step, choose "Use SQL statements" and click Next. After that, please enter the following SQL Statement:
SELECT ProductID, Name, ProductModel FROM Production.vProductAndDescription WHERE (CultureID = N'en')
Specifying a SQL Statement that returns AdventureWorks Product info
- After that, add a new custom Column to the DataTable just created and name it Barcode as is shown in the following figure
Adding a new Column to the DataTable for barcoding purpose
- Change the data type of the Barcode column to System.Byte[] (Array of Byte). NOTE: the System.Byte[] data type is not listed and thus why you must type it manually.
Setting up the Barcode Column to System.Byte[] data type
- Save the AdventureWorks.xsd file.
- Now add a new Report item to the project.
Adding a local report (RDLC) to the project
- The data source for the report should look like the following figure. NOTE: You can display Data Sources Window by selecting Data menu and then Show Data Sources (Shift+Alt+D)
The DataSet is available to be used in the report
- Please design the report so it looks like the following figure.
The barcode report layout
The report features a Table item with 3 columns:
1º Column: It holds an Image item. Drag & drop an Image item into it and set its properties as is shown in the following figure. Notice that Value property of the Image item is bound to the Barcode column.
The Image item's properties. The Value property is bound to Barcode Column.
2º Column: It holds the Name field
3º Column: It holds the ProductModel field
- Save the report.
- Now Create/Open a Windows Form at design time and drag & drop a ReportViewer control onto it and set the local report to display.
A ReportViewer control to display the barcode report
- After that, from the Solution Explorer, add a reference to Barcode Professional for Windows Forms assembly: Neodynamic.WinControls.Barcodeprofessional.dll
- Write the following code in the Form_Load event procedure.
Visual Basic .NET
Visual C# .NET
That's it. Run your application. You should get the barcode images displayed on the report.
The local report featuring barcodes generated by Barcode Professional
ReportViewer control lets you to export the displayed report to Acrobat PDF as well as Microsoft Excel XLS. In both cases the barcode images are maintained.
The local report in Acrobat PDF format featuring barcodes generated by Barcode Professional
TIP: How to export to Acrobat PDF the Local Report with Barcode images without Preview
The following walkthrough shows how to programmatically export a local report to PDF without viewing it.
Follow these steps:
- Add a new Windows Form to the project and drag & drop a Button control onto it as is shown in the following figure.
A simple Windows Form to programmatically export a local report to PDF without viewing it
- Be sure your project is referencing the following assemblies:
Microsoft.ReportViewer.Common.dll
Microsoft.ReportViewer.WinForms.dll
Neodynamic.WinControls.BarcodeProfessional.dll
- Double click on the Button control and write the following code in the Button1_Click event procedure.
Visual Basic .NET
Visual C# .NET
- That's it. Run your project opening the last form and click on the button to generate the PDF version for the barcode report.
The local report featuring barcodes exported to PDF format without previewing it onto the Windows Form
Using Custom Objects as data source of my local report
You can design local reports (RDLC) based on business objects defined in your application. In this scenario, an object data source is simply a collection of arbitrary objects. In this guide, we'll define a custom object with barcoding support that will be used as data source for our report.
Follow these steps:
Add a new class item to the project and name it Product.
Adding a Product Class item
The Product class will feature basic info about products such is ID and Name as well as a special property called Barcode which will hold the barcode image for each product object.
Please write the following Product class definition:
Visual Basic .NET
Visual C# .NET
- Save the class file and go to Build menu and click on Build Solution
- Add a new Report item to the project.
Adding a local report (RDLC) to the project
- Then, go to Data menu and click on Add new Data Source...
Selecting Object Data Source for the local report
In the Data Source Configuration Wizard choose Object and click Next.
Choosing Product Class as the Object Data Source
Select the class you wish to use as a data source (Product in our case) and click Finish. The public properties of the class now appear in the Data Sources window, where they can be dragged and dropped into the report. NOTE: You can display Data Sources Window by selecting Data menu and then Show Data Sources (Shift+Alt+D)
The Product Class is available to be used in the report
- Please design the report so it looks like the following figure.
The barcode report layout
The report features a Table item with 3 columns:
1º Column: It holds an Image item. Drag & drop an Image item into it and set its properties as is shown in the following figure. Notice that Value property of the Image item is bound to the Barcode column.
The Image item's properties. The Value property is bound to Barcode Column.
2º Column: It holds the Name field
3º Column: It holds the Id field
- Save the report.
- Create/Open a Windows Form at design time and drag & drop a ReportViewer control onto it and set the local report to display.
A ReportViewer control to display the barcode report
- After that, from the Solution Explorer, add a reference to Barcode Professional for Windows Forms assembly: Neodynamic.WinControls.Barcodeprofessional.dll
- Write the following code in the Form_Load event procedure.
Visual Basic .NET
Visual C# .NET
That's it. Run your application. You should get the barcode images displayed on the report.
The local report featuring barcodes generated by Barcode Professional
ReportViewer control lets you to export the displayed report to Acrobat PDF as well as Microsoft Excel XLS. In both cases the barcode images are maintained.
The local report in Acrobat PDF format featuring barcodes generated by Barcode Professional
TIP: How to export to Acrobat PDF the Local Report with Barcode images without Preview
The following walkthrough shows how to programmatically export a local report to PDF without viewing it.
- Add a new Windows Form to the project and drag & drop a Button control onto it as is shown in the following figure.
A simple Windows Form to programmatically export a local report to PDF without viewing it
- Be sure your project is referencing the following assemblies:
Microsoft.ReportViewer.Common.dll
Microsoft.ReportViewer.WinForms.dll
Neodynamic.WinControls.BarcodeProfessional.dll
- Double click on the Button control and write the following code in the Button1_Click event procedure.
Visual Basic .NET
Visual C# .NET
- That's it. Run your project opening the last form and click on the button to generate the PDF version for the barcode report.
The local report featuring barcodes exported to PDF format without previewing it onto the Windows Form
If you need more information or assistance, please contact our
.
|
|
|
|