فئة 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 المدفوع بالسحب