Click here to Skip to main content
12,748,873 members (40,844 online)
Click here to Skip to main content
Add your own
alternative version

Stats

344.3K views
4.8K downloads
139 bookmarked
Posted 6 Apr 2005

DaReport PrintDocument - a printing utility for .NET

, 20 Apr 2006
Rate this:
Please Sign up or sign in to vote.
A printing utility for .NET.

Screenshot

Introduction

This component helps you generate simple but useful reports for printing in .NET. The idea is to generate XML-based templates, and then to call them from your program, and eventually to fill them with the data required. This is appropriate for generating small and simple printing documents.

Background

The basic class of this project is DaPrintDocument. It inherits from the standard .NET class PrintDocument. Therefore, you can use it pretty much the same way as the PrintDocument class.

This class simply paints attached drawing objects within its PrintPage() method. For simplicity, there are only four types of drawing objects supported: TextField (simple formatted text), PictureBox (images), ChartBox (simple charts), and StyledTable (table with static or dynamically loaded data).

Template file overview

DaPrintDocument makes use of template files written in XML syntax. Those provide all static information relevant for printing a page.

You can write template files in any text editor, or alternatively, use the DaReport Designer (beta) provided in the distribution (it's a separate application: DaReportDesigner.exe).

The brief overview of the XML structure:

<daReport>

<parameters>
   <parameter name="parameter1_name" />
   <parameter name="parameter2_name" />
</parameters>

<content>

<!-- Static objects are evaluated once per report -->
<staticContent>

      <!-- The list of static objects goes here. 
         Check in reportStatic.xml (in download package). -->
     
</staticContent>

<!-- Dynamic objects are evaluated once per page of report 
      (like data table segment or page number) -->
<dynamicContent>

      <!-- The list of dynamic objects goes here. 
        Check in reportDynamic.xml (in download package). -->

</dynamicContent>

</content>
</daReport>

Once again, the preferred way for XML template file generation is by using the DaReport Designer (beta) provided in the distribution.

Using the code

First, add a reference to the daReport.dll file (provided in the distribution) to your project. If you feel like it, you can also put this component in your controls toolbar.

Second, add an instance of DaPrintDocument to your module (form); if you have previously attached it in your controls toolbar, simply drag it to your form:

private daReport.DaPrintDocument daPrintDocument = 
                         new daReport.DaPrintDocument();

At the point where you wish to print some report, set the template file and fill in the parameters (if any):

// set .xml file for printing
daPrintDocument.setXML("reportStatic.xml");

// fill in declared parameters (if any)
// (parameter names are case sensitive)
Hashtable parameters = new Hashtable();
parameters.Add("author","Predrag Dukanac");
daPrintDocument.SetParameters(parameters);

Using tables

  • Static tables: static tables have data defined in an XML template file (DATA tag). The DataSource property for these tables is not set. No specific action is required in code for these tables to print correctly (everything is done in the .xml file).
  • Dynamic tables: dynamic tables present data calculated in your program (like database reports). The DataSource property is set, and must correspond to the DataTable.Name property in your code. Do it like this:
    // myTable is DataTable previously filled from database
    // (using DataAdapter.Fill method, for instance)
    
    DataTable printTable = myTable.Copy();
    printTable.Name = "printTable";
    // this is the DataSource attribute of my table in XML file
    
    // attach DataTable to printing document
    daPrintDocument.AddData(printTable);
    
    // now you're ready for print

Take a look at reportStatic.xml, reportDynamic.xml, reportCharts.xml, and the ReportTest project (all in the download package) for a deeper insight.

Latest update

The DaReport print engine has turned into a commercial product - Stampa Reports System®. A Stampa Reports demo is available for download here. Stampa designer features backward compatibility with daReport in design mode. The Stampa printing engine can be used free of charge.

The DaReport project at this address is still an open-source project by all means.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Share

About the Author

Predrag Dukanac
Web Developer
Serbia Serbia
Working at Mihajlo Pupin Institute, Belgrade, Serbia.

You may also be interested in...

Comments and Discussions

 
Newswww.stampa-reports.com Pin
Predrag Dukanac7-Dec-12 4:14
memberPredrag Dukanac7-Dec-12 4:14 
GeneralRe: www.stampa-reports.com Pin
Tajniak511-Mar-13 5:57
memberTajniak511-Mar-13 5:57 
QuestionStampa Reports Pin
Aciobanita Costel18-Oct-12 2:30
memberAciobanita Costel18-Oct-12 2:30 
GeneralMy vote of 5 Pin
biye5u1-Mar-12 21:08
memberbiye5u1-Mar-12 21:08 
QuestionThanks a lot for this nice utility. Pin
Sunil Apte13-Oct-11 22:02
memberSunil Apte13-Oct-11 22:02 
Questionparameter in static table Pin
MCY5-Dec-10 2:43
memberMCY5-Dec-10 2:43 
GeneralMy vote of 5 Pin
Anirudha_baba5-Jul-10 0:22
memberAnirudha_baba5-Jul-10 0:22 
QuestionMem usage problem!!!!!!!!!!! [Report design] Pin
utehn9-Jan-09 0:37
memberutehn9-Jan-09 0:37 
QuestionUSE FREE Pin
Member 323381631-Dec-08 6:00
memberMember 323381631-Dec-08 6:00 
AnswerRe: USE FREE Pin
fraser12530-Jun-12 18:51
memberfraser12530-Jun-12 18:51 
Generalprinters on c#.net Pin
balu1234530-Jul-08 8:41
memberbalu1234530-Jul-08 8:41 
QuestionHow can I draw text or table only at the end of last page? Pin
JM ® - DE CASTRO11-Jun-08 12:58
memberJM ® - DE CASTRO11-Jun-08 12:58 
GeneralVery nice Pin
Hugo Faselo13-Dec-07 12:16
memberHugo Faselo13-Dec-07 12:16 
QuestionRe: Very nice Pin
dimazoid16-Oct-08 9:34
memberdimazoid16-Oct-08 9:34 
QuestionMonday's date at the top of the report. Pin
damonhogan16-Nov-07 6:48
memberdamonhogan16-Nov-07 6:48 
Questionmultple page in staticContent [modified] Pin
abhishek nath5-Feb-07 21:28
memberabhishek nath5-Feb-07 21:28 
AnswerRe: multple page in staticContent Pin
negleden25-May-09 15:46
membernegleden25-May-09 15:46 
QuestionWhat royalties do i need to add into the help file? Pin
NarutoFan#131-Oct-06 20:50
memberNarutoFan#131-Oct-06 20:50 
AnswerRe: What royalties do i need to add into the help file? Pin
Predrag Dukanac1-Nov-06 0:36
memberPredrag Dukanac1-Nov-06 0:36 
GeneralRe: What royalties do i need to add into the help file? Pin
NarutoFan#11-Nov-06 4:58
memberNarutoFan#11-Nov-06 4:58 
GeneralHow to add image path? Pin
NarutoFan#128-Feb-07 23:41
memberNarutoFan#128-Feb-07 23:41 
QuestionReportDesigner Pin
bszom13-Oct-06 12:38
memberbszom13-Oct-06 12:38 
QuestionFromPage/ToPage question Pin
bp00321-Jul-06 11:13
memberbp00321-Jul-06 11:13 
GeneralFormatMask question Pin
calvin_cch3-Jun-06 16:40
membercalvin_cch3-Jun-06 16:40 
QuestionHow to print page numbers? Pin
steve_dee25-May-06 5:10
membersteve_dee25-May-06 5:10 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.170215.1 | Last Updated 20 Apr 2006
Article Copyright 2005 by Predrag Dukanac
Everything else Copyright © CodeProject, 1999-2017
Layout: fixed | fluid