Table of Contents |
|
WordApplication's ImportData method allows you to import blocks of data to a worksheet from a database or a rectangular array. ImportData is a method of both Element and Table. Element.importData returns a Table object representing a table in the document that contains the imported data.Table.importData adds an new row to an existing table.
Importing from a Database
You can import values from a database to a table in your document by passing the ImportData method a DataTable, DataView, SqlDataReader, OleDbDataReader, or AdomdDataReader.
The DataTable and DataView classes are in the System.Data namespace. Use an Import directive to import the namespace to the aspx page:
<%@ Import namespace="System.Data" %> |
To import System.Data to a C# code-behind page (.aspx.cs), use:
To import database values using OleDb, import the System.Data.OleDb namespace to your page. To import database values using SqlClient, import the System.Data.SqlClient namespace to your page.
To import values from a database to your document:
- Connect to the database and execute a query to return a DataTable, DataView, SqlDataReader, OleDbDataReader, or AdomdDataReader, for example:
private DataTable GetEmployeeDataTable()
{
string employeeSQL = "SELECT TOP 10 FirstName + ' ' + LastName As Name, " +
"Title FROM Employees";
DataTable dt = new DataTable();
using(SqlConnection conn = new SqlConnection(connString))
new SqlDataAdapter(employeeSQL, conn).Fill(dt);
return dt;
}
|
- Create a document:
WordApplication wwApp = new WordApplication();
Document doc = wwApp.Create();
|
- Pass the DataTable returned from the database to ImportData:
Table employeesTable = doc.ImportData(dt);
|
Importing from an Array
- Create a rectangular array, for example:
string[,] arrayData = {{"Nancy", "Davolio", "Sales Manager"},
{"Michael", "Suyama", "HR Representative"},
{"Adrian", "King", "IS Support"}};
|
- Create a document:
WordApplication wwApp = new WordApplication();
Document doc = wwApp.Create();
|
- Pass the array to ImportData:
Table employeesTable = doc.ImportData(arrayData);
|
Customizing Your Data Import
The DataImportProperties class contains a set of properties that are used when importing data to a table in a document. The settings of a DataImportProperties object will be applied to a data import if the object is passed to ImportData (with the set of values to import). You can create several DataImportProperties objects and assign a different one to each data import, or re-use one object in multiple ImportData calls.
To customize a data import using a DataImportProperties object:
- Create a DataImportProperties object:
WordApplication wwApp = new WordApplication();
Document doc = wwApp.Create();
DataImportProperties importProps = doc.CreateDataImportProperties();
|
- Set one or more data import properties:
//--- Import column names to the first row of the table.
importProps.UseColumnNames = true;
//--- Automatically resize the table's columns and rows to fit
//--- the imported data.
importProps.AutoFit = true;
|
- Define a DataTable, DataView, SqlDataReader, OleDbDataReader, AdomdDataReader or rectangular array, for example:
OleDbConnection Conn = new OleDbConnection();
DataTable employeeDt = null;
int employeeId;
try
{
Conn.ConnectionString = Application["connstring"].ToString();
//--- SQL Query for employee information
string employeeSQL = "SELECT FirstName + ' ' + LastName As Name, Title " +
"FROM Employees WHERE employeeID=?";
OleDbCommand cmdEmployee = new OleDbCommand(employeeSQL, Conn);
cmdEmployee.Parameters.Add("@employeeID", employeeID);
OleDbDataAdapter adptEmployee = new OleDbDataAdapter(cmdEmployee);
employeeDt = new DataTable();
adptEmployee.Fill(employeeDt);
}
|
- Pass the data and the DataImportProperties object to ImportData:
Table importTable = doc.ImportData(employeeDt , importProps);
|