Menu
Free Trials
Table of contents

Connecting to relational database with .NET

Requirements

  • Flexmonster Pivot Component v2.213 PROFESSIONAL edition or higher
  • Microsoft .NET Framework 4 or higher
  • Driver for the database

Supported databases

  • Oracle Database – driver
  • MySQL – driver
  • Microsoft SQL Server – driver is built-in
  • PostgreSQL – driver
  • Other ADO.NET / ODBC databases

Step 1: Embed the component into your web page

Embedding Flexmonster Pivot is a simple copy-paste procedure that takes just minutes!

  1. Copy contents of flexmonster/ folder into the web project root to your server.
  2. Copy the code below and paste it into your HTML page.
<div id="pivotContainer">The component will appear here</div>
<script src="flexmonster/lib/jquery.min.js"></script>
<script src="flexmonster/flexmonster.js"></script>

<script>
	var pivot = $("#pivotContainer").flexmonster({
		toolbar: true,
		licenseKey: "XXXX-XXXX-XXXX-XXXX-XXXX"
	});
</script>

Run your web page and see the empty table. The next step is to see your own data on the grid.

Step 2: Setup Data Compressor on the server

First of all, you need to add the following dependencies to your project:

  • Appropriate database driver. Please note that Microsoft SQL Server driver is built-in.
  • Flexmonster.Compressor.dll – it is located in the Download Package

Below is the connection and query sample for MS SQL Server:

string connectionString = "Server=localhost;Database=XXX;";
SqlConnection sqlConnection = new SqlConnection(connectionString);
sqlConnection.Open();
string query = "SELECT * FROM YYY";
DbCommand command = new SqlCommand(query, sqlConnection);
DbDataReader reader = command.ExecuteReader();

The following line of code will convert DbDataReader to compressed Stream:

Stream inputStream = Flexmonster.Compressor.CompressDb(reader);

Now, you can create a response from the Stream. For simple cases, it is enough to read all content:

string output = new StreamReader(inputStream).ReadToEnd();

Also, it is possible to create streaming response. It means that the end user will get the response almost without delay and server will use less amount of memory. It is recommended way for large datasets:

HttpResponseMessage response = Request.CreateResponse();
response.Content =
    new PushStreamContent((Stream outputStream, HttpContent content, 
                           TransportContext context) =>
    {
        int length = 0;
        byte[] buffer = new byte[10240];
        while ((count = inputStream.Read(buffer, 0, buffer.Length)) > 0)
        {
            outputStream.Write(buffer, 0, length);
            outputStream.Flush();
        }
        outputStream.Close();
    }, new MediaTypeHeaderValue("text/plain")
);

Full project is available at the server/.net/ inside Download Package.

Step 3: Enable cross-origin resource sharing (CORS).

By default, browser prevents JavaScript from making requests across domain boundaries. CORS allows web applications to make cross-domain requests. Here are some useful links explain how to setup CORS on your server:

Step 4: Configure report with your own data

Now it’s time to configure Flexmonster Pivot Component on the web page. Let’s create a minimal report for this (replace filename and other parameters with your specific values):

var pivot = $("#pivotContainer").flexmonster({
	toolbar: true,
	report: {
		dataSource: {
			dataSourceType: "ocsv",
			/* URL to the Data Compressor .NET */
			filename: "http://localhost:55772/api/flexmonster/get"
		}
	},
	licenseKey: "XXXX-XXXX-XXXX-XXXX-XXXX"
});

Launch the web page from browser — here you go! Pivot table is embedded into your project.

Examples

Saving to file

string connectionString = "Server=localhost;Database=XXX;";
SqlConnection sqlConnection = new SqlConnection(connectionString);
sqlConnection.Open();
string query = "SELECT * FROM YYY";
DbCommand command = new SqlCommand(query, sqlConnection);
DbDataReader reader = command.ExecuteReader();

Stream inputStream = Flexmonster.Compressor.CompressDb(reader);
FileStream fileStream = File.Create("data.ocsv");
inputStream.CopyTo(fileStream);
fileStream.Close();