Export Service | ComponentOne CandlestickChart for ASP.NET Web Forms

Export Service

In This Topic

Use the C1 ASP.NET Export Service, to export Charts as images or PDF, without creating a complex export application. This service resides on the application server.

The advantages of using C1 ASP.NET Export Service are:

Export your charts, while preserving their formatting.
Change exported file settings as per the requirement.

Export Service is a web-application and is deployed on Internet Information Services (IIS). Run the C1ASPNETExportService installer, placed in C:\Program Files\ComponentOne\ASP.NET Web Forms Edition folder. It installs the following files in IIS.

You can also find these files at the following location:

C:\ProgramData\ComponentOne\C1ASPNET\C1APNETExportService

System Requirements

Following are the system requirements of the service host:

Microsoft Windows 7 or above.
IIS 7.0 or above with ASP.NET 4.0 or above ( .NET framework 4.0 ).
IE9 or higher on the service host.

You may update .Net framework 4.0 in Microsoft Windows 7 or Microsoft Windows Server 2008 R2. See http://support.microsoft.com/kb/2468871, for more information.

Export Settings for Charts

Following are the settings to export charts.

Export as Image

FileFormat: Exports as a .jpg, .bmp, .gif, .png or a .tiff image.
Author: Specifies the name of the person or organization responsible for creating the data.
Server URL: Sets the server URL. Enter ServerURL/exportapi/chart.
File Name: Sets the file name to be used for the exported image.

Export to PDF

Auto Fit Width: Enables auto-fit.
Landscape: Enables landscape mode.
File Content:
- Image Quality: Sets the image quality to Low, Medium or High
- Compression: Sets the compression level to Default, None, Best Speed or Best Compression.
- Font Type: Sets the Font type to True Type or Embedded.
Document Info:
- Author: Sets the name of the person or organization that created the document.
- Creator: Sets the name of the application that created the original document.
- Subject: Sets the subject of the document.
- Title: Sets document title in the title bar.
- Producer: Sets the name of the application that created the PDF document.
- Keywords: Sets the keywords associated with the PDF document that can be used to locate the document.
Document Security:
- Encryption Type: Sets the Encryption Type to NotPermit, Standard40, Standard128 or Aes128.
- Owner Password: Sets the password required to edit permissions for the document.
- User Password: Sets the password required to open the document.
- Allow Copy Content: Enables or disables copy content.
- Allow Edit Annotations: Enables or disables users from editing annotations.
- Allow Edit Content: Enables or disables users from editing content in the document.
- Allow Print: Enables or disables printing for the document.
Configuration Setting:
- Server URL: Sets the server URL. Enter ServerURL/exportapi/chart.
- File Name: Sets the file name to be used for the exported PDF.

Usage

The exportChart method will be called to export the chart as an image or a PDF. These steps assume that you have added a button to the form, on whose click event you would call the export function. Add the following code within the <head></head> tags, to export chart to an image:

	Copy Code
<script src="http://code.jquery.com/jquery-1.9.1.min.js" type="text/javascript"></script> <asp:PlaceHolder runat="server"> <!--Export Methods--> <script type="text/javascript"> $(function () { $("#Button1").click(exportImage); }); function getChart() { return $("#<%=C1CandlestickChart1.ClientID%>"); } // Export function function exportImage() { var fileName ="ExportImage"; var type = "Png"; var url = "http://demos.componentone.com/ASPNET/ExportService" + "/exportapi/chart"; var chart = getChart(); $("#<%=C1CandlestickChart1.ClientID%>").c1candlestickchart"exportChart", fileName, type, url); } </script> </asp:PlaceHolder>

Copy Code

<script src="http://code.jquery.com/jquery-1.9.1.min.js" type="text/javascript"></script>
<asp:PlaceHolder runat="server">
    <!--Export Methods-->
   <script type="text/javascript">
       $(function () {
           $("#Button1").click(exportImage);
       });
       function getChart() { return $("#<%=C1CandlestickChart1.ClientID%>"); }

       // Export function
       function exportImage() {
           var fileName ="ExportImage";
           var type = "Png";
           var url = "http://demos.componentone.com/ASPNET/ExportService" + "/exportapi/chart";
           var chart = getChart();
          $("#<%=C1CandlestickChart1.ClientID%>").c1candlestickchart"exportChart", fileName, type, url);
    }
</script>
    </asp:PlaceHolder>

Add the following code within the <head></head> tags, to export chart to PDF:

	Copy Code
<script src="http://code.jquery.com/jquery-1.9.1.min.js" type="text/javascript"></script> <asp:PlaceHolder runat="server"> <script type="text/javascript"> $(function () { $("#Button1").click(exportPdf); }); // Export function function exportPdf() { var fileName = "ExportCharts"; var url = "http://demos.componentone.com/ASPNET/ExportService" + "/exportapi/chart"; var pdfSetting = { imageQuality:'Low', compression: 'BestCompression', fontType: 'TrueType', author: 'ComponentOne', creator: 'ComponentOne', subject: 'Export Chart', keywords: 'bar chart, chart, export, pdf', allowCopyContent: true, allowEditAnnotations: true, allowEditContent: true, allowPrint: true } $("#<%=C1CandlestickChart1.ClientID%>").c1candlestickchart("exportChart", fileName, "pdf", pdfSetting, url); } </script> </asp:PlaceHolder>

Copy Code

<script src="http://code.jquery.com/jquery-1.9.1.min.js" type="text/javascript"></script>
    <asp:PlaceHolder runat="server">
<script type="text/javascript">
    $(function () {
        $("#Button1").click(exportPdf);
    });   
        
    // Export function
    function exportPdf() {
        var fileName = "ExportCharts";
        var url = "http://demos.componentone.com/ASPNET/ExportService" + "/exportapi/chart";
        var pdfSetting = {
            imageQuality:'Low',
            compression: 'BestCompression',
            fontType: 'TrueType',
            author: 'ComponentOne',
            creator: 'ComponentOne',
            subject: 'Export Chart',
            keywords: 'bar chart, chart, export, pdf',
            allowCopyContent: true,
            allowEditAnnotations: true,
            allowEditContent: true,
            allowPrint: true
        }
        
        $("#<%=C1CandlestickChart1.ClientID%>").c1candlestickchart("exportChart", fileName, "pdf", pdfSetting, url);
    }
</script>
        </asp:PlaceHolder>

The following image displays the properties of the PDF generated:

In case the file does not download on Internet Explorer, turn off Internet Explorer protected mode to export file or run Internet Explorer as administrator. To turn off the protected mode:

Open Internet Explorer Settings and select Internet Options.
In the Security tab select Internet and uncheck "Enable Protected Mode".