Promotic
WikipediaLinkedInYoutubeTwitterFacebook

SaveToFile - metoda objektu PmDataTable

Popis:
Uložení dat tohoto objektu do souboru typu CSV nebo DBF. Uloží se všechny sloupce a řádky.
Syntaxe:
SaveToFile(sFile As String, sParams As String) As Boolean
Volání:
b = oDataTable.SaveToFile(sFile, sParams)
Parametry:
sFile(String) Cesta k souboru (s cestou), do kterého se mají data uložit. Pokud není zadána celá cesta, doplní se relativně vzhledem k souborové složce aplikace.

Je doporučeno použít cestu v syntaxi PROMOTIC - viz PROMOTIC cesta k souborům nebo složkám.

sParams(String) Textový seznam parametrů definující způsob uložení do souboru. Údaje s přiřazenou hodnotou jsou zde odděleny středníkem, například "filetype:csv;fmt:standard;".
"filetype:xxx;" (povinné) - Určuje typ souboru definovaný parametrem sFile. Jsou možné tyto typy souboru:
csv - typ je CSV soubor. Je to víceřádkový soubor textových hodnot oddělených například středníkem. Je běžně využívaný například v programu MsExcel.
dbf - typ je DBF soubor ve formátu dBASE III. Je běžně využívaný například v programu MsExcel.
"fmt:xxx;" (nepovinné) - Určuje formát uložených dat v daném souboru. Jsou možné tyto formáty:
"standard" (přednastaveno) - (jen pro CSV) hodnoty v řádcích tabulky jsou uloženy na odpovídající řádky CSV souboru
"head:xxx;" (nepovinné) - (jen pro CSV) Určuje, zda v souboru bude uložena i jednořádková hlavička s názvy sloupců. Povolené hodnoty jsou:
no (přednastaveno) - hlavička není vložena.
name - hlavička je vložena, v hlavičce jsou názvy veličin.
"delimiter:xxx;" (nepovinné) - (jen pro CSV) Oddělovač hodnot v CSV souboru. Povolené hodnoty jsou:
semicolon (přednastaveno) - odddělovač je středník.
comma - odddělovač je čárka.
space - odddělovač je mezera.
tab - odddělovač je tabelátor.
number - tj. oddělovač je zadán dekadickým číslem ASCII znaku, například "delimiter:124;" znamená oddělovač "|" (vertikální čára).
"date.fmt:xxx;" (nepovinné) - Formát času a datumu. Povolené hodnoty jsou:
system (přednastaveno) - formát času a data je určen nastavením OS Windows (např. 22.11.2010 16:30:15).
pm - PROMOTIC formát času a data na celé sekundy (např. 2010.11.22 16:30:15).
pmmili - PROMOTIC formát času a data na milisekundy (např. 2010.11.22 16:30:15.250).
real - formát času a datumu datového typu Date v podobě reálného čísla (např. 41392.123456789).
"real.dsep:xxx;" (nepovinné) - (jen 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 OS Windows (např. 3,14).
dot - desetinný oddělovač je (bez ohledu na nastavení OS Windows) tečka (např. 3.14).
comma - desetinný oddělovač je (bez ohledu na nastavení OS Windows) čárka (např. 3,14).
"lastcolsep:xxx;" (nepovinné)
yes - Při zápisu se přidá separátor 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) - Separátory jsou jenom mezi hodnotami na řádku a nikoliv na konci řádku. Z hlediska CSV souboru je toto správně.
"string.len:nnn;" (nepovinné) - (jen pro DBF) Maximální délka řetězce, implicitně je 32.
Vrácená hodnota:
true - uložení proběhlo v pořádku
false - v opačném případě
Příklad1:
Uložení dat do souboru Data.csv uloženého ve složce aplikace. Oddělovač hodnot bude středník, desetinný oddělovač reálných čísel bude tečka a formát datumu bude v PROMOTIC systémovém tvaru.
oDataTable.SaveToFile"#app:Data.csv", "filetype:csv;delimiter:semicolon;real.dsep:dot;date.fmt:pm;"
Příklad2:
Uložení dat do souboru Data.dbf uloženého ve složce aplikace. Datum bude v PROMOTIC systémovém tvaru.
oDataTable.SaveToFile"#app:Data.csv", "filetype:dbf;date.fmt:pmmili;"
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice