The following table describes the available .NET versions of ComponentOne reporting and previewing products. Note that the list has been numbered to differentiate between versions (this product, Reports for WPF, is #7 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.2.dll C1.Win.C1PrintPreview.Classic.2.dll |
C1PrintDocument C1PrintPreview |
|
4 |
Reports for .NET |
.NET 2.0 |
C1.Win.C1Report.2.dll |
C1Report
|
|
5 |
Preview for .NET |
.NET 2.0 |
C1.C1Preview.2.dll C1.Win.C1Preview.2.dll |
C1PrintDocument C1PreviewPane C1PrintPreviewControl C1PrintPreviewDialog C1PreviewThumbnailView C1PreviewOutlineView C1PreviewTextSearchPanel |
|
6 |
Reports for WinForms |
.NET 2.0 |
C1.C1Report.2.dll C1.Win.C1Report.2.dll |
C1Report C1PrintDocument C1PreviewPane C1PrintPreviewControl C1PrintPreviewDialog C1PreviewThumbnailView C1PreviewOutlineView C1PreviewTextSearchPanel |
|
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:
This is the "classic" version of 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.
This is the old .NET 2.0 version of 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.
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 cannot 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.
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.
The WPF version of reporting and preview controls which includes Preview for .NET 2.0 (#5) and Reports for .NET 2.0 (#4). This product can be used in .NET 3.0 and 3.5 applications.