| sFile | (String) Název souboru s cestou, ze kterého se mají data načíst. Soubor nemusí mít příponu "ini" nebo "csv", typ souboru se určuje podle zadaného parametru filetype.
Pokud není zadána celá cesta, pak se doplní relativně k složce aplikace. Je doporučeno použít cestu v syntaxi PROMOTIC - viz PROMOTIC cesta k souborům nebo složkám. |
|---|---|
| sParams | (String) Dodatečné parametry definující způsob čtení ze souboru. Údaje jsou zde ve formátu KeyVal, například "filetype:ini;fmt:trans;rowname:boiler;".
"filetype:xxx;" (povinné) - Určuje typ souboru definovaný v parametru sFile
csv - typ je CSV soubor. Je to víceřádkový soubor textových hodnot například oddělené středníkem. Je běžně využívaný například v programu MsExcel. "fmt:xxx;" (nepovinné) - Určuje formát uložených dat v souboru.
Výchozí hodnota je "fmt:standard;". Jsou možné tyto formáty: standard - Význam závisí na typu souboru:
csv - Hodnoty v řádcích CSV souboru jsou uloženy na odpovídající řádky v tabulce
ini - Sekce souboru INI jsou názvy řádků a klíče souboru INI jsou názvy sloupců tabulky. Příklad:
[r0]colname1=boiler1colname2=boiler2[r1]colname1=12colname2=15trans - Sekce souboru INI jsou názvy sloupců tabulky a klíče souboru INI jsou názvy řádků. Příklad:
[colname1]r0=boiler1r1=12[colname2]r0=boiler2r1=15"rowname:xxx;" (nepovinné) - (pouze pro INI) Určuje název řádku.
Pokud není nastaveno, pak se předpokládá hodnota "rowname:r;". Název řádku se vytvoří tímto textem doplněným o index řádku, například pokud "rowname:rrr;", pak názvy řádků budou "rrr0", "rrr1", atd. "colnameheader:xxx;" (nepovinné) - (pouze pro CSV)
no (přednastaveno) - už v prvním řádku souboru jsou uložena data.
yes - v prvním řádku souboru nejsou data ale názvy jednotlivých sloupců. "delimiter:xxx;" (nepovinné) - (pouze pro CSV) Oddělovač hodnot v souboru CSV. Povolené hodnoty jsou:
semicolon (přednastaveno) - oddělovač je středník.
comma - oddělovač je čárka.
space - oddělovač je mezera.
tab - oddělovač je tabulátor.
number - tzn. oddělovač je zadán číslem ASCII znaku (decimálně), například "delimiter:124;" znamená oddělovač "|" (svislá čára). "date.fmt:xxx;" (nepovinné) - Formát datumu a času. Povolené hodnoty jsou:
system (přednastaveno) - formát datumu a času je určen v nastavení v OS Windows (např. 22.11.2010 16:30:15).
pm - PROMOTIC formát datumu a času na celé sekundy (např. 2010.11.22 16:30:15).
pmmili - PROMOTIC formát datumu a času - přesnost 10 ms (např. 2010.11.22 16:30:15.250).
real - formát datumu a času datového typu Date typu reálné číslo (např. 41392.123456789). "real.dsep:xxx;" (nepovinné) - (pouze pro CSV) Formát desetinného oddělovače u reálných čísel. Povolené hodnoty jsou:
system (přednastaveno) - desetinný oddělovač je určen nastavením v OS Windows (např. 3,14).
dot - desetinný oddělovač je tečka (nezávisle na nastavení OS Windows) (např. 3.14).
comma - desetinný oddělovač je čárka (nezávisle na nastavení OS Windows) (např. 3,14). "lastcolsep:xxx;" (nepovinné)
yes - Při zápisu se přidá oddělovač za poslední hodnotou na řádku, při načtení se prázdná hodnota na konci každého řádku ignoruje. Z hlediska CSV souboru to není správně.
no (přednastaveno) - Oddělovače jsou pouze mezi hodnotami na řádku a nikoliv na konci řádku. Z hlediska CSV souboru je toto správně. |
var oDataTable = pMe.Pm("/DataTable");
oDataTable.LoadFromFile("#app:CfgData.csv", "filetype:csv;colnameheader:no;delimiter:semicolon;real.dsep:dot;date.fmt:pm;");
var oDataTable = pMe.Pm("/DataTable");
oDataTable.LoadFromFile("#app:CfgData.ini", "filetype:ini;rowname:boiler;");