Documentație HotXLS

Clasa TXLSForwardReader

TXLSForwardReader prezintă o singură suprafață proiectată, bazată pe callback-uri, pentru intrarea XLS clasic, XLSX modern, CSV și TSV, fără a construi un model complet de obiecte al registrului de lucru

Format de intrare

TXLSForwardFormat selectează detectarea automată sau forțează analizarea XLS, XLSX, CSV sau TSV

ReadFile deschide o sursă denumită, iar ReadStream citește din poziția curentă a fluxului apelantului, restabilind acea poziție la revenire

Proiecție și limite de rând

IncludeColumn adaugă o coloană bazată pe 0 la setul de proiecție cu timp constant, ClearColumnProjection restaurează ieșirea cu toate coloanele, iar HasColumnProjection raportează dacă împingerea este activă

FirstRow și LastRow aplică limite de rând bazate pe 1 înainte de expedierea callback-urilor, permițând analizatoarelor să se oprească după intervalul solicitat

Callback-uri și conversia valorilor

OnSheetPrimește numele fiecărei foi de lucru și poate sări peste o foaie sau să anuleze întreaga citire
OnCellPrimește rândul, coloana, indicele de stil, tipul normalizat, valoarea brută și textul formulei pentru fiecare celulă proiectată
DetectDatesFolosește formatele numerice ale registrului de lucru pentru a identifica valorile de dată și oră
DetectTextTypesConvertește câmpurile CSV și TSV în tipuri scalare acceptate acolo unde este lipsit de ambiguitate
PreserveRichTextPăstrează rândurile formatate și conținutul fonetic acolo unde formatul sursă le acceptă
ValueSeparatorSuprascrie separatorul de câmpuri text atunci când detectarea formatului nu este adecvată

Stare de finalizare

CellCount raportează celulele expediate, iar Aborted distinge anularea de către apelant de finalizarea normală

Exemplu

Reader := TXLSForwardReader.Create;
try
  Reader.FirstRow := 2;
  Reader.IncludeColumn(0);
  Reader.IncludeColumn(4);
  Reader.OnSheet := ReadSheet;
  Reader.OnCell := ReadCell;
  Reader.ReadFile('large-input.xlsx', xffAuto);
finally
  Reader.Free;
end;

Alegerea unei API de streaming

Folosiți TXLSForwardReader când o singură cale de aplicație trebuie să accepte mai multe formate, TXLSDirectReader pentru aspectul specific XLSX, textul bogat și evenimentele paralele ale foii de lucru, sau TXLSRowCursor pentru iterarea rândurilor XLSX condusă prin pull

Consultați și