مستندات HotXLS

فئة TXLSForwardReader

TXLSForwardReader مصدرًا مسمى ويقرأ TXLSRowCursor من موضع تيار المتصل الحالي مع استعادة ذلك الموضع عند العودة

الإسقاط وحدود الصفوف

TXLSForwardFormat يضيف

ReadFile opens a named source and ReadStream تقرأ من موضع الدفق الحالي لدى المستدعي مع استعادة ذلك الموضع عند العودة

Projection and row bounds

IncludeColumn عمودًا قائمًا على الصفر إلى مجموعة الإسقاط ذات الزمن الثابت، ويعيد ClearColumnProjection إخراج جميع الأعمدة، ويُبلّغ HasColumnProjection عما إذا كان الدفع نشطًا

FirstRow و LastRow حدود الصفوف القائمة على الواحد قبل توزيع الاستدعاء، مما يسمح للمحللات بالتوقف بعد الفاصل الزمني المطلوب

الاستدعاءات وتحويل القيم

OnSheetيستقبل اسم كل ورقة عمل وقد يتخطى ورقة أو يلغي القراءة الكاملة
OnCellيستقبل الصف والعمود وفهرس النمط والنوع المطبَّع والقيمة الخام ونص الصيغة لكل خلية مُسقَطة
IncludeFormulaTextيستخدم تنسيقات أرقام المصنف لتحديد قيم التاريخ والوقت
DetectDatesيحوّل حقول CSV وTSV إلى أنواع قياسية مدعومة عندما يكون ذلك واضحًا
DetectTextTypesيحتفظ بالتشغيلات المنسَّقة والحمولة الصوتية حيثما يدعم تنسيق المصدر ذلك
PreserveRichTextيتجاوز فاصل حقول النص عندما لا يكون اكتشاف التنسيق مناسبًا
ValueSeparatorتتجاوز فاصل الحقول النصية عندما لا يكون اكتشاف التنسيق مناسبًا

HasFormula is false for ordinary values, while FormulaTextAvailable is true only when Formula يحتوي على نص موثوق؛ يعرض XLS الكلاسيكي نتائج الصيغ المخزّنة مؤقتًا مع عدم توفّر نص الصيغة، لأن المسار الأمامي لا يفكك رموز BIFF

حالة الاكتمال

CellCount reports dispatched cells and Aborted يميّز إلغاء المستدعي عن الاكتمال العادي

ClassicBytesRead تعرض إجمالي البايتات التي استهلكها محلّل XLS الكلاسيكي (BIFF) و ClassicPeakBufferedBytes ذروة البايتات المخزّنة مؤقتًا التي احتفظ بها دفعة واحدة؛ وكلاهما بيانات تشخيصية للقراءة فقط لمسار XLS الكلاسيكي

PeakRowBufferedBytes تعرض أكبر مجموعة عمل مقدَّرة للصفوف المنطقية يحتفظ بها الـ backend المشترك، و SheetPassesStarted تحسب جولات أوراق العمل التي أصبحت نشطة؛ والورقة التي يرفضها OnSheet لا تفتح جزء ورقة العمل الخاص بها ولا تزيد العداد

يُبلّغ OnSheet عن الخلايا المرسَلة ويميّز OnCell بين إلغاء المتصل والاكتمال العادي

مثال

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

اختيار واجهة برمجة بث

استخدم TXLSForwardReader عندما يجب أن يقبل مسار تطبيق واحد عدة تنسيقات، أو TXLSDirectReader لتخطيط خاص بـ XLSX والنص المنسق وأحداث ورقة العمل المتوازية، أو TXLSRowCursor لتكرار صفوف XLSX المدفوع بالسحب

انظر أيضًا