Scopo
Esporta i dati del pannello in formato CSV e ritorna il nome del file. Se richiesto apre il file nel browser dell'utente. Questa funzione viene chiamata quando l'utente preme il bottone Esporta nella toolbar del pannello, specificando l'apertura del file nel browser.
Sintassi
string nf = "" // Nome file CSV
//
nf := Pannello.ExportData(apri file)
//
nf := Pannello.ExportData(apri file)
Argomenti
apri file | Parametro opzionale booleano. Se impostato a True (default) richiede l'apertura del file CSV nel browser dell'utente. |
encoding | Parametro facoltativo il cui valore predefinito è la codifica predefinita dell'ambiente (normalmente Windows-1252 su Windows, UTF-8 su Linux). |
Valore di ritorno
Viene ritornata una stringa che contiene il percorso completo del file CSV creato.
- Il separatore utilizzato all'interno del file CSV dipende dal valore del parametro di applicazione UseDecimalDot: se il parametro vale True viene utilizzato, come separatore, il carattere ',' (virgola); se il parametro vale False viene utilizzato il carattere ';' (punto e virgola).
- Il file CSV viene creato nella sottodirectory temp dell'applicazione web in modo che sia visibile al browser.
- Il file creato viene considerato temporaneo (usando internamente la AddTempFile) e verrà cancellato al termine della sessione web in corso.
- A partire dalla versione 8.0.3560 di Instant Developer la chiamata alla funzione ExportData causa la notifica dell'evento OnCommand del pannello.
- A partire dalla versione 9.0.3940 di Instant Developer il sistema esporta solo i record selezionati nel pannello se è attiva e visibile la multi-selezione delle righe (vedi EnableMultipleSelection e ShowMultipleSelection).
- A partire dalla versione 10.5.4660 di Instant Developer se un campo di pannello possiede una maschera il sistema la utilizza per formattare il valore durante l'esportazione dei dati. Attenzione: il sistema non utilizza maschere impostate all'interno dell'evento OnDynamicProperties del pannello. Allo stesso modo il sistema non utilizza maschere di stili visuali se lo stile visuale dei campi viene modificato all'interno dell'evento OnDynamicProperties del pannello.
Ultima modifica: 10/01/2023 / Validità: da 6.5.2680