11
Working with Windows.Forms
create your report. Read more about this in the User's Manual;
close the report designer;
add a "Button" control on your form;
double-click it and write the following code in the button_Click event handler:
report1.Show();
save the project and run it. When you click on a button you will see the prepared report.
Working with report in a code
To work with Report component in a code, you need to do the following:
create a report instance;
load a report file into it;
register the application-defined data in a report;
pass the values into the report parameters, if needed;
run the report.
The following example demonstrates how to do this:
using (Report report = new Report())
{
report.Load("report1.frx");
report.RegisterData(dataSet1, "NorthWind");
report.Show();
}
We will consider these steps in details in the following sections of this manual.
Best pdf to jpg converter for - Convert PDF to JPEG images in C#.net, ASP.NET MVC, WinForms, WPF project
How to convert PDF to JPEG using C#.NET PDF to JPEG conversion / converter library control SDK
change pdf file to jpg; reader pdf to jpeg
Best pdf to jpg converter for - VB.NET PDF Convert to Jpeg SDK: Convert PDF to JPEG images in vb.net, ASP.NET MVC, WinForms, WPF project
Online Tutorial for PDF to JPEG (JPG) Conversion in VB.NET Image Application
convert multi page pdf to jpg; batch pdf to jpg
12
Working with Windows.Forms
Storing and loading a report
You may store a report in the following ways:
Method
Description
in the
application's
resources
The typical scenario of using the Report, which we looked at before, uses
this method. The StoreInResources property of the Report object is
responsible for this. This property is set to true by default. This method
has the following pros and cons:
+ a report is embedded into your application, you don't need to deploy
extra files;
- if you need to change a report, you have to recompile your application.
Loading a report is performed automatically. To do this, FastReport.Net
adds a code into the InitializeComponent method of your form.
in the .FRX file
This method is useful if you want to give your users the ability to change a
report. In this case, set the report's StoreInResources property to false
To load the report from a file, use the Load method of the Report object:
report1.Load("filename.frx");
in the database
You may store a report in the database, either as a string or in a blob-
stream. 
To load the report from a string, use the LoadFromString method of the
Report object. To load the report from a stream, use the overloaded
version of the Load method:
report1.Load(stream);
To support the load/save operations in the report designer, you need to
replace the "Open File" and "Save File" dialogs in the designer. Read here
how to do this.
as a C#/VB.
NET class
To work with a report as a class, design your report and save in to the .
cs/.vb file. To do this, select "file type" in the "Save" dialog. The file type
maybe either .cs or .vb - it depends on the script language in the report (it
may be changed in the "Report|Options..." menu). Include that file into
your project. This method has the following pros and cons:
+ you can work with a report as a class;
+ you may debug a report;
+ this is the only way to use a report in ASP.NET project running on
medium trust environment;
- you cannot edit such a report. To do this, you need the original .FRX file;
- if you need to change a report, you have to recompile your application.
To work with a report, create an instance of the report's class:
SimpleListReport report = new SimpleListReport();
Online Convert PDF to Jpeg images. Best free online PDF JPEG
Online PDF to JPEG Converter. Download Free Trial. Convert a PDF File to JPG. Drag and drop your PDF in the box above and we'll convert the files for you.
convert pdf to jpg 300 dpi; convert pdf to jpg file
Online Convert Jpeg to PDF file. Best free online export Jpg image
Online JPEG to PDF Converter. Download Free Trial. Convert a JPG to PDF. You can drag and drop your JPG file in the box, and then start
convert pdf to jpeg on; convert pdf pages to jpg
13
Working with Windows.Forms
report.Show();
Registering data
If your report uses data from an application (for example, the typed dataset or a business-
object), you have to register such data in a report. This can be done using the RegisterData
method of the Report object.
When you use the Report as described in the "Using the Report component in Visual Studio"
section, you don't need to register the data. FastReport.Net does it automatically (it adds the
RegisterData call in the InitializeComponent method of your form).
The RegisterData method must be called after you have loaded the report:
report1 = new Report();
report1.Load("report.frx");
report1.RegisterData(dataSet1, "NorthWind");
The RegisterData method is overloaded and allows to register the following data:
Method
Description
void RegisterData(
DataSet data)
Registers the dataset. This method registers all tables, views
and relations as well.
Attention: if you register more than one dataset, use the
RegisterData(DataSet data, string name) method instead.
void RegisterData(
DataSet data, 
string name)
Registers the dataset. Specify any name in the 
name
parameter
(it must be persistent and unique if you register more than one
dataset).
void RegisterData(
DataTable data, 
string name)
Registers the data table. 
void RegisterData(
DataView data, 
string name)
Registers the data view.
void RegisterDataAsp(
IDataSource data, 
string name)
Registers the ASP.NET data source such as AccessDataSource.
void RegisterData(
DataRelation data, 
string name)
Registers the relation.
void RegisterData(
IEnumerable data, 
string name, 
BOConverterFlags flags, 
int maxNestingLevel)
Registers the business object. Specify what items (properties,
fields) should be used, in the 
flags
parameter. Specify the
maximum nesting level in the 
maxNestingLevel
parameter
(typically you need no more than 3 levels). Several nested
objects may slow down the report.
C# WPF PDF Viewer SDK to convert and export PDF document to other
Best PDF Viewer control as well as a powerful .NET WinForms application to image file formats with high quality, support converting PDF to PNG, JPG, BMP and
convert pdf pictures to jpg; change pdf to jpg format
C# PDF Convert to Images SDK: Convert PDF to png, gif images in C#
Best PDF converter SDK for Visual Studio .NET for converting PDF to image in C#.NET Support exporting PDF to multiple image forms, including Jpg, Png, Bmp
convert pdf to jpg for online; c# pdf to jpg
14
Working with Windows.Forms
Passing a value to a report parameter
The report may have parameters. Read more about this in the User's Manual. To pass a value
to the parameter, use the SetParameterValue method of the Report object:
report1.Load("report.frx");
report1.SetParameterValue("MyParam"10);
report1.Show();
This method is declared as follows:
public void SetParameterValue(string complexName, object value)
Specify the parameter's name in the 
complexName
parameter. To access a nested parameter,
use its full name, for example:
"ParentParameter.ChildParameter"
Running a report
To run a report, use one of the following methods of the Report object:
Method
Description
void Show()
Runs a report and shows it in the preview window. This method is equal
to:
if (Prepare())
ShowPrepared();
bool Prepare()
Runs a report. If the report was prepared successfully, returns true.
After this method, you need to call one of the following methods:
ShowPrepared, PrintPrepared, SavePrepared, Export:
if (Prepare())
ShowPrepared();
bool Prepare(
bool append)
Runs a report. If the 
append
parameter is set to true, the prepared
report will be added to the existing one. So you can build several
reports and display them in the preview as one report:
report1.Load("report1.frx");
report1.Prepare();
report1.Load("report2.frx");
report1.Prepare(true);
report.ShowPrepared();
void ShowPrepared()
Shows a prepared report in the preview window. The report must be
either prepared using the Prepare method, or loaded from the .FPX file
using the LoadPrepared method:
if (Prepare())
C# Create PDF from images Library to convert Jpeg, png images to
Best and professional C# image to PDF converter SDK for Visual Studio .NET. Batch convert PDF documents from multiple image formats, including Jpg, Png, Bmp, Gif
change pdf to jpg file; batch pdf to jpg converter online
VB.NET PDF - Convert PDF with VB.NET WPF PDF Viewer
Best WPF PDF Viewer control as well as a powerful PDF converter. PDF to image file formats with high quality, support converting PDF to PNG, JPG, BMP and GIF.
convert pdf pages to jpg online; best program to convert pdf to jpg
15
Working with Windows.Forms
ShowPrepared();
void ShowPrepared(
bool modal)
Shows a prepared report in the preview window. The 
modal
parameter
determines whether the preview should be shown modally.
void ShowPrepared(
bool modal, 
Form owner)
The same as the previous method. The 
owner
parameter determines a
window that owns the preview window. 
void ShowPrepared(
Form mdiParent)
The same as the previous method. The 
mdiParent
parameter
determines the main MDI window.
Designing a report
You can use the report designer in your application. This is possible for all FastReport.Net
editions except the Basic. To do this, use the Design method of Report object:
report1 = new Report();
report1.Load("report1.frx");
report1.Design();
The Design method is overloaded:
Method
Description
bool Design()
Shows the designer.
bool Design(
bool modal)
Shows the designer. The 
modal
parameter determines whether it is
necessary to show the designer modally.
bool Design(
Form mdiParent)
Shows the designer. The 
mdiParent
parameter defines the main MDI
window.
Exporting a report
The prepared report can be exported to one of the supported formats. At this moment, the
following formats can be used:
PDF
HTML
RTF
Excel XML (Excel 2003+)
Excel 2007
CSV
TXT
OpenOffice Calc
Pictures (Bmp, Png, Jpeg, Gif, Tiff, Metafile)
The export is performed by the export filter. To do this:
VB.NET Create PDF from images Library to convert Jpeg, png images
Best and professional image to PDF converter SDK for Visual Studio .NET. Support create PDF from multiple image formats in VB.NET, including Jpg, Png, Bmp
convert pdf to 300 dpi jpg; conversion pdf to jpg
VB.NET PDF Convert to Images SDK: Convert PDF to png, gif images
Best adobe PDF to image converter SDK for Visual Studio .NET. Convert PDF documents to multiple image formats, including Jpg, Png, Bmp, Gif, Tiff, Bitmap
convert pdf into jpg; pdf to jpeg converter
16
Working with Windows.Forms
prepare a report using the Prepare method;
create an instance of export filter and set up its properties;
call the Export method of the Report object.
The following example exports a prepared report in the HTML format:
// prepare a report
report1.Prepare();
// create an instance of HTML export filter
FastReport.Export.Html.HTMLExport export = new FastReport.Export.Html.HTMLExport();
// show the export options dialog and do the export
if (export.ShowDialog())
report1.Export(export, "result.html");
In this example, export settings are made using the dialog window.
Configuring the FastReport.Net environment
Using the EnvironmentSettings component which is available in the Toolbox, you can control
some FastReport.Net environment settings. To do this, put the component on your form and
set up its properties using the Properties window.
The EnvironmentSettings.ReportSettings property contains some report-related settings:
Property
Description
Language DefaultLanguage
The default script language for new reports.
bool ShowProgress
Determines whether it is necessary to show the progress window.
bool ShowPerformance
Determines whether to show the information about the report
performance (report generation time, memory consumed) in the
lower right corner of the preview window.
The EnvironmentSettings.DesignerSettings property contains some designer-related settings:
Property
Description
Icon Icon
The icon for the designer window.
Font DefaultFont
The default font used in a report.
The EnvironmentSettings.PreviewSettings property contains some preview-related settings:
Property
Description
PreviewButtons Buttons
Set of buttons that will be visible in the preview's toolbar.
int PagesInCache
The number of prepared pages that can be stored in the memory
cache during preview.
bool ShowInTaskbar
Determines whether the preview window is displayed in the
Windows taskbar.
17
Working with Windows.Forms
bool TopMost
Determines whether the preview window should be displayed as a
topmost form.
Icon Icon
The icon for the preview window.
string Text
The text for the preview window. If no text is set, the default text
"Preview" will be used.
The EnvironmentSettings.EmailSettings property contains email account settings. These
settings are used in the "Send Email" feature in the preview window:
Property
Description
string Address
Sender address (e.g. your email address).
string Name
Sender name (e.g. your name).
string MessageTemplate
The message template that will be used to create a new message.
For example, "Hello,   Best regards, ...".
string Host
SMTP host address. 
int Port
SMTP port (25 by default).
string UserName,
string Password
User name and password. Leave these properties empty if your
server does not require authentication.
bool AllowUI
Allows to change these settings in the "Send Email" dialog.
Settings will be stored in the FastReport.Net configuration file.
UI style settings are available in the following properties of EnvironmentSettings component:
Property
Description
UIStyle UIStyle
The style of designer and preview form. 6 styles are available -
VisualStudio2005, Office2003, Office2007Blue, Office2007Silver,
Office2007Black, VistaGlass. 
The default style is Office2007Black.
bool UseOffice2007Form
This property affects the designer and preview form. It determines
whether the Office2007-style form should be used if one of the
following styles is selected: Office2007Blue, Office2007Silver,
Office2007Black, VistaGlass.
Default value is true.
Besides these properties, the EnvironmentSettings component has some events. Using such
events, you may do the following:
replace standard "Open file" and "Save file" dialogs in the designer;
replace standard progress window;
pass own connection string to a connection defined in the report.
These tasks will be described in the following sections of this manual.
18
Working with Windows.Forms
Replacing the "Open" and "Save" dialogs
If you decided to store a report in the database, you may need to change the designer in such
a way that it can open and save reports from/to a database. That is, you need to replace
standard "Open" and "Save" dialogs with your own dialogs that work with database. To do this,
use the EnvironmentSettings component (see the previous section). This component has the
following events:
Event
Description
CustomOpenDialog
Occurs when the report designer is about to show the "Open" dialog. In
the event handler, you must display a dialog window to allow user to
choose a report file. If dialog was executed successfully, you must
return e.Cancel = false and set the e.FileName to the selected file
name.
The following example demonstrates how to use this event:
private void CustomOpenDialog_Handler(
object sender, OpenSaveDialogEventArgs e)
{
using (OpenFileDialog dialog = new OpenFileDialog())
{
dialog.Filter = "Report files (*.frx)|*.frx";
// set e.Cancel to false if dialog 
// was succesfully executed
e.Cancel = dialog.ShowDialog() != DialogResult.OK;
// set e.FileName to the selected file name
e.FileName = dialog.FileName;
}
}
CustomSaveDialog
Occurs when the report designer is about to show the "Save" dialog. In
the event handler, you must display a dialog window to allow user to
choose a report file. If dialog was executed successfully, you must
return e.Cancel = false and set the e.FileName to the selected file
name.
The following example demonstrates how to use this event:
private void CustomSaveDialog_Handler(
object sender, OpenSaveDialogEventArgs e)
{
using (SaveFileDialog dialog = new SaveFileDialog())
{
dialog.Filter = "Report files (*.frx)|*.frx";
// get default file name from e.FileName
dialog.FileName = e.FileName;
// set e.Cancel to false if dialog 
// was succesfully executed
e.Cancel = dialog.ShowDialog() != DialogResult.OK;
// set e.FileName to the selected file name
e.FileName = dialog.FileName;
}
19
Working with Windows.Forms
}
CustomOpenReport
Occurs when the report designer is about to load the report. In the
event handler, you must load the report specified in the e.Report
property from the location specified in the e.FileName property. The
latter property contains the name that was returned by the
CustomOpenDialog event handler. It may be the file name, the
database key value, etc.
The following example demonstrates how to use this event:
private void CustomOpenReport_Handler(
object sender, OpenSaveReportEventArgs e)
{
// load the report from the given e.FileName
e.Report.Load(e.FileName);
}
CustomSaveReport
Occurs when the report designer is about to save the report. In the
event handler, you must save the report specified in the e.Report
property to the location specified in the e.FileName property. The
latter property contains the name that was returned by the
CustomSaveDialog event handler. It may be the file name, the
database key value, etc.
The following example demonstrates how to use this event:
private void CustomSaveReport_Handler(
object sender, OpenSaveReportEventArgs e)
{
// save the report to the given e.FileName
e.Report.Save(e.FileName);
}
Replacing the standard progress window
The progress window is shown during the following actions:
running a report
printing
exporting
You may turn off the progress by setting the ReportSettings.ShowProgress property of the
EnvironmentSettings component to false. Besides that, you may replace the standard progress
window with your own. To do this, use the following events of the EnvironmentSettings
component (see the "Configuring the FastReport.Net environment" section):
Event
Description
StartProgress
Occurs once before the operation. In this event, you have to create your
own progress window and show it.
Progress
Occurs each time when current report page is handled. In this event, you
20
Working with Windows.Forms
have to show the progress state in your window.
FinishProgress
Occurs once after the operation. In this event, you have to destroy the
progress window.
The Progress event takes 
e
parameter of ProgressEventArgs type. It has the following
properties:
Property
Description
string Message
The message text.
int Progress
The index of current report page being handled.
int Total
The number of total pages in a report. This parameter may be 0 when
preparing a report, because the number of total pages is unknown.
In most cases, you need to display the text from the e.Message property, in the Progress
event handler. Other parameters may be useful if you want to display a progress bar.
Passing own connection string
If you use data sources that are defined inside a report, you may need to pass an application-
defined connection string to a report. This can be done in three ways.
The first method: you pass a connection string directly to the Connection object in a report.
Do the following:
report1.Load(...); 
// do it after loading the report, before running it
// assume we have one connection in the report
report1.Dictionary.Connections[0].ConnectionString = my_connection_string;
report1.Show();
The second method: you pass a connection string using the report parameter. Do the
following:
run the report designer;
in the "Data" window, create a new report parameter (with "MyParameter" name, for
example). See the User's Manual for more details;
in the "Data" window, select the "Connection" object that contains a data source;
switch to the "Properties" window and set the ConnectionStringExpression property to the
following:
[MyParameter]
pass the connection string to the MyParameter parameter:
report1.SetParameterValue("MyParameter", my_connection_string);
The third method: use the DatabaseLogin event of the EnvironmentSettings component (see
the "Configuring the FastReport.Net environment" section). This event occurs each time when
FastReport opens the connection. Here is an  example of this event handler:
private void environmentSettings1_DatabaseLogin(
Documents you may be interested
Documents you may be interested