Reports and Preview .NET Versions
In This Topic
The Reports for WinForms product has evolved through several versions. The current version (#6 in the table below) is a combination of the .NET 2.0 Preview for .NET and Reports for .NET products. The following table describes the available .NET versions of reporting and previewing products. Note that the list has been numbered to differentiate between versions (this product, Reports for WinForms, is #6 below):
| # |
Name |
.NET Framework |
Assemblies |
Controls |
| 1 |
Preview for .NET |
.NET 1.x |
C1.C1PrintDocument.dll C1.Win.C1PrintPreview.dll |
C1PrintDocument C1PrintPreview |
| 2 |
Reports for .NET |
.NET 1.x |
C1 C1.Win.C1Report.dll |
C1Report |
| 3 |
Preview Classic for .NET |
.NET 2.0 |
C1.C1PrintDocument.Classic.4.dll C1.Win.C1PrintPreview.Classic.4.dll |
C1PrintDocument C1PrintPreview |
| 4 |
Reports for .NET |
.NET 2.0 |
C1.Win.C1Report.4.dll |
C1Report |
| 5 |
Preview for .NET |
.NET 2.0 |
C1.C1Preview.4.dll C1.Win.C1Preview.4.dll |
C1PrintDocument C1PreviewPane C1PrintPreviewControl C1PrintPreviewDialog C1PreviewThumbnailView C1PreviewOutlineView C1PreviewTextSearchPanel |
| 6 |
Reports for WinForms |
.NET 2.0 |
C1.C1Report.4.dll C1.Win.C1Report.4.dll C1.Win.C1ReportDesigner.4.dll |
C1Report C1PrintDocument C1PreviewPane C1PrintPreviewControl C1PrintPreviewDialog C1PreviewThumbnailView C1PreviewOutlineView C1PreviewTextSearchPanel C1ReportDesigner |
| 7 |
Reports for WPF |
.NET 3.0 |
C1.WPF.C1Report.dll C1.WPF.C1Report.Design.dll C1.WPF.C1Report.VisualStudio.Design.dll |
C1DocumentViewer |
Version Compatibility
While the products above provide reporting and previewing functionality and may include similar components, they are not all backwards compatible. Some considerations for upgrading versions are discussed below:
- Preview Classic for .NET (.NET 2.0, #3 in the above table)
This is the "classic" version of ComponentOne's preview controls. While the assembly names are different from #1, these are 100% backwards compatible, so upgrading from the .NET 1.x product (#1 above) does not require any changes except for changing the references in your project and licenses.licx files. Preview Classic for .NET is no longer actively developed and is in maintenance mode.
- Reports for .NET (.NET 2.0, #4 above)
This is the old .NET 2.0 version of ComponentOne's reporting controls. These reports can be shown by all versions of preview controls (#1, #3 or #5 above), by assigning the C1Report.Document property to the Document property of a preview control.
- Preview for .NET (.NET 2.0, #5 above)
This is the newer previewing product (new compared to the classic version). This product has different code and object model from the previous versions (#1or #3 above). Automatic conversion from #1 or #3 to this product is not supported; in particular the Convert2Report.exe utility can not convert those older projects. Converting from #1 or #3 to this preview requires rewriting user code, always. The scope of changes differs and may be trivial, but code must be updated by hand.
- Reports for WinForms (.NET 2.0, #6 above)
The current .NET 2.0 combined reporting and previewing product. This includes both the "new" preview (#5 above) and reports (#4 above). Unlike in previous versions, to preview a C1Report, it itself (rather than its Document property) should be assigned to the Document property of the preview control. This build is backwards code compatible with #4 and #5, but assembly references and namespaces must be updated. The changes are always trivial and can be made manually or by using the Convert2Report.exe utility which can be downloaded from ComponentOne HelpCentral.
- Reports for WPF (.NET 3.0, #7 above)
2.0 (#5) and Reports for .NET 2.0 (#4). This product can be used in .NET 3.0 and 3.5 applications.
