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:
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:
- Create a document:
- Pass the DataTable returned from the database to ImportData:
Importing from an Array
- Create a rectangular array, for example:
- Create a document:
- Pass the array to ImportData:
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:
- Set one or more data import properties:
- Define a DataTable, DataView, SqlDataReader, OleDbDataReader, AdomdDataReader or rectangular array, for example:
- Pass the data and the DataImportProperties object to ImportData: