TDataGrid.LoadFromCSV

TDataGrid = class (TObject)Interface de TDataGridExemples de TDataGrid

Charge une chaîne au format CSV dans une grille

Syntaxe

procedure LoadFromCSV(csvData: String; separatorChar: String = ','; quoteChar: String = '"') (Qubes 9.0)
procedure LoadFromCSV(csvData: String; separatorChar: String; quoteChar: String)
procedure LoadFromCSV(csvData: array of String; separatorChar: String = ','; quoteChar: String = '"') (Qubes 10.0)
procedure LoadFromCSV(csvData: String; separatorChar: String = ','; quoteChar: String = '"'; preserveWhiteSpace: Boolean = False) (Qubes 10.0)
procedure LoadFromCSV(csvData: array of String; separatorChar: String = ','; quoteChar: String = '"'; preserveWhiteSpace: Boolean = False) (Qubes 10.0)
csvData: chaîne à importer au format CSV
separatorChar: caractère de séparation entre 2 champs
quoteChar: caractère de début et fin de champ texte
preserveWhiteSpace:

Remarques

Résumé rapide du format CSV :

  • Les différentes lignes d'un fichier CSV sont séparées par un retour chariot
  • Au sein d'une même ligne, les différents champs sont séparés par le caractère de séparation separatorChar
  • Si un champ contient le caractère separatorChar, le champ doit être délimité par le caractère de délimitation de texte quoteChar
  • Si un champ contient un retour chariot, le champ doit être délimité par le caractère de délimitation de texte quoteChar
  • Si un champ contient le caractère quoteChar, le champ doit être délimité par le caractère de délimitation de texte quoteChar et toutes les occurrences de quoteChar dans le champ doivent être doublées

LoadFromCSV supprime toutes les colonnes de la DataGrid et les champs de la première ligne de csvData deviennent les noms des colonnes de la DataGrid.
Qubes essaye de "deviner" l'ordre de tri des colonnes importées avec LoadFromCSV.
Pour forcer l'ordre de tri après l'import, utiliser la propriété ColumnSortStyle.

Voir AsCSV pour convertir une grille au format CSV.

Exemples

var csvData := #'
   Code,Nom,Description
   1,Test 1,"Données'#13#10'multilignes"
   2,Test 2,"Données séparées, par des espaces"
   3,Test 3,"Données contenant des ""guillemets"""
';

var dgExemple := TDataGrid.Create;
dgExemple.LoadFromCSV(csvData, ',', '"');
dgExemple.Goto(2);
Print(dgExemple.CellData[2]); // Affiche : Données contenant des "guillemets"

Classification

DataGrid TDataGrid