Design Forms

CustomDataTable

CustomDataTable (cDT) represents table of in-memory data.
cDT is direct descendant of c# DataTable object

Syntax:
object cDT = new CustomDataTable(<file_name>);

Parameters:
string filename - relative path to XML file containing data.
Search starts from folder "Public Documents\DesignForms_4\CustomLibrary".


Most important properties and methods:
Rows
Columns
Select


SDF extension methods:
Convert()
Converts data in cDT from string to strongly-typed values (number, string, boolean or structure)

Return value
object (CustomDataTable) with converted values.

Remarks:
CustomDataTable constructor loads data from XML file without any conversions. All the values in cells in table are string (text). This saves time necessary to convert all the values.
You can use this command to convert table immediately after loading:
object cDT = new CustomDataTable(<file_name>).Convert();
Convert method can be time consuming (especially for huge datatables). Use it just in justified case!


GetStructure(DataRow R)
Convert given data row to strongly-typed SDF structure.
This command can be used with converted as well as original (unconverted) CustomDataTable. Necessary conversions are provided for unconverted datarow.

Return value
object (structure) which contains strongly typed data from given DataRow.

Parameters:
DataRow R - row to be converted to SDF structure.

from version 6.0

You can't use this command to convert table immediately after loading:
object cDT = new CustomDataTable(<file_name>).Convert();

Correct procedure is:
object cDT = new CustomDataTable(<file_name>);
cDT = cDT.Convert();