Page History

{description}
{excerpt}Imports data from a rectangular array of objects  to the specified [Area|Area]. The new data will +overwrite+ values and formulas in the target worksheet cells, but existing formatting will be preserved.{excerpt}
{signature:C#}
 public Area ImportData(System.Object[,] data, System.String[] columnNames, DataImportProperties props)
{signature}{signature:vb.net}
Public Function ImportData(ByVal data As Object(,), ByVal columnNames As String(), ByVal props As DataImportProperties) As Area
{signature}
{parameters}
{param:data}A rectangular array of values to import to the worksheet.       The first dimension corresponds to row and the second to column.
        Thus, an array of data  \{ \{"A","X"\},\{"B","Y"\},\{"C","Z"\} \}  would be inserted into the worksheet as:\|A|X|
|B|Y|
|C|Z|

        If you enable [DataImportProperties.Transpose|DataImportProperties.Transpose] , the format will be \[row\]\[column\], so:
         \{ \{"A","B","C"\},\{"X","Y","Z"\} \}  would be inserted into the worksheet as:\|A|X|
|B|Y|
|C|Z|
{param}
{param:columnNames}A string array of column names.{param}
{param:props}A [DataImportProperties|DataImportProperties] object that contains a set of properties that will determine the behavior of the data import.{param}
{returns}An {{Area}} object representing the set of cells populated with the imported values.{returns}
{example}{code:csharp|title=C#}

DataImportProperties importProps = wb.CreateDataImportProperties();
importProps.Transpose = true;
Area importedArea = a.ImportData(dataArray, fieldNames, importProps);
{code}
{code:vbnet|title=vb.net}

Dim importProps As DataImportProperties = wb.CreateDataImportProperties()
importProps.Transpose = True
Dim importedArea As Area = a.ImportData(dataArray, fieldNames, importProps)
{code}

{example}
{scrollbar}