معالج ملفات Aspose.Words XLSX لـ .NET

Aspose.Words XLSX معالج الملفات ل .NET يسمح لك إنشاء، فتح، تعديل، وتخزين الكتب المكتبية XLSX بالكامل في الرمز الذي يتم إدارته.مصنوعة على مجموعة فرعية متسارعة من محرك الأسبوس.الخلايا ومصممة للاندماج مع خط أنابيب تحويل الأسبر.الكلمات، فإنه يوفر الأداء العالي توليد / تحرير Excel لتطبيقات الخادم، أدوات سطح المكتب، وخدمات السحابة-بدون أوتوماتيك Office.

يركز على XLSX: ورقة عمل، الخلايا، الأنماط، الصيغ، الرسوم البيانية، استيراد / تصدير البيانات، التحقق، وحماية.

تثبيت وإعداد

  • قم بتثبيت حزمة NuGet Aspose.Words (والحزمة XLSX File Processor Plugin ، إذا تم توزيعها بشكل منفصل).
  • قم بتطبيق ترخيصك عند بدء التطبيق لإزالة حدود التقييم: انظر مقياس الترخيص .
  • بالنسبة لأهداف الإطار وإرشادات التنفيذ، انظر تثبيت .

يستخدم هذا المكون الإضافي محرك Excel المقطوع داخليًا ويحتاج لا إلى Microsoft Excel.

**المنصات المدعومة: ** ويندوز، لينكس، ماكوس (.NET Framework، .NET Core، NET 5/6+، Mono).وقت التشغيل: x64/x86؛ خادم وبيئات سطح المكتب.

البدء السريع: إنشاء وتخزين XLSX 

using Aspose.Cells; // Engine behind the plugin

// 1) Create a workbook with one worksheet
var wb = new Workbook();
Worksheet sheet = wb.Worksheets[0];
sheet.Name = "Report";

// 2) Populate header + data
sheet.Cells["A1"].PutValue("Product");
sheet.Cells["B1"].PutValue("Qty");
sheet.Cells["C1"].PutValue("Price");
sheet.Cells["D1"].PutValue("Total");

sheet.Cells["A2"].PutValue("Keyboard");
sheet.Cells["B2"].PutValue(12);
sheet.Cells["C2"].PutValue(39.99);
sheet.Cells["D2"].Formula = "=B2*C2";

// 3) Style header
var style = wb.CreateStyle();
style.Font.IsBold = true;
style.ForegroundColor = System.Drawing.Color.AliceBlue;
style.Pattern = BackgroundType.Solid;
var flags = new StyleFlag { FontBold = true, CellShading = true };
sheet.Cells.CreateRange("A1", "D1").ApplyStyle(style, flags);

// 4) Auto-fit and save
sheet.AutoFitColumns();
wb.Save("Report.xlsx", SaveFormat.Xlsx);

تحميل، تحرير، وإعادة حساب 

using Aspose.Cells;

var load = new LoadOptions(LoadFormat.Xlsx);
using var fs = File.OpenRead("Input.xlsx");
var wb = new Workbook(fs, load);

// Update a value and a formula
Worksheet ws = wb.Worksheets["Summary"] ?? wb.Worksheets[0];
ws.Cells["B5"].PutValue(1250);            // new revenue
ws.Cells["B6"].Formula = "=B5*0.18";     // tax 18%

// Calculate formulas only for this sheet to save time
var calcOpts = new CalculationOptions { CalcStackSize = 2000 };
wb.CalculateFormula(calcOpts);

wb.Save("Updated.xlsx", SaveFormat.Xlsx);

البيانات المستوردة (DataTable → ورقة العمل) 

using System.Data;
using Aspose.Cells;

DataTable dt = GetData(); // your source
var wb = new Workbook();
var ws = wb.Worksheets[0];

ws.Cells.ImportDataTable(dt, isFieldNameShown: true, firstRow: 0, firstColumn: 0, insertRows: true);
ws.AutoFitColumns();

wb.Save("DataImport.xlsx", SaveFormat.Xlsx);

إدخال خريطة (مرتبطة بالبيانات) 

var wb = new Workbook();
var ws = wb.Worksheets[0];

// Sample data
ws.Cells["A1"].PutValue("Month");
ws.Cells["B1"].PutValue("Sales");
string[] months = {"Jan","Feb","Mar","Apr"};
int[] sales = {120, 150, 170, 190};
for (int i = 0; i < months.Length; i++) { ws.Cells[i+1,0].PutValue(months[i]); ws.Cells[i+1,1].PutValue(sales[i]); }

// Add chart
int idx = ws.Charts.Add(ChartType.Column, 6, 0, 20, 8);
Chart chart = ws.Charts[idx];
chart.Title.Text = "Monthly Sales";
chart.NSeries.Add("B2:B5", true);
chart.NSeries.CategoryData = "A2:A5";

wb.Save("Chart.xlsx", SaveFormat.Xlsx);

إضافة التحقق من البيانات وحماية ورقة 

var wb = new Workbook();
var ws = wb.Worksheets[0];

// Allow only whole numbers between 1 and 100 in B2:B100
Validation v = ws.Validations[ws.Validations.Add()];
v.Type = ValidationType.WholeNumber;
v.Operator = OperatorType.Between;
v.Formula1 = "1";
v.Formula2 = "100";
CellArea area = CellArea.CreateCellArea("B2", "B100");
v.AddArea(area);

// Protect sheet but allow editing unlocked cells
ws.Protection = new Protection { AllowEditingContent = true };
wb.Save("Validated.xlsx", SaveFormat.Xlsx);

الخصائص والوظائف

كتاب العمل Creation & Loading

  • كتب عمل جديدة مع أوراق وأساليب افتراضية.
  • تحميل XLSX من file/stream/byte[] مع تقرير خطأ قوي.
  • الكشف عن الحزم المحمية كلمة المرور والهياكل غير المشروعة.

ورشة عمل إدارة

  • إضافة/كلون/حذف/تحريك ورقة عمل؛ خفية/لا يخفى علامات التبويب.
  • العنوان بواسطة index أو الاسم.

الخلايا & Ranges

  • اقرأ / اكتب السلاسل والأرقام والتاريخ والبوولين.
  • العمليات الكبيرة عبر نطاقات النطاق العالي.
  • توفير البيانات المدعومة دون إزعاج حجم الملف.

التصميم & Formatting

  • تنسيقات الأرقام وأقنعة التاريخ / الوقت المخصصة.
  • الخطوط، ملء، الحدود؛ أسماء الأنماط لإعادة الاستخدام.
  • قواعد تشكيل مشروطة.

صيغة و إعادة حساب

  • جميع وظائف Excel الشائعة (SUM، AVERAGE، VLOOKUP، IF، إلخ.).
  • إعادة حساب ورقة أو كتاب عمل كامل من أجل الأداء.
  • الوصول إلى القيم المخفية والحسابات الطازجة.

الرسم البياني & الرسومات

  • عمود / بار / خط / Pie / منطقة / خرائط سكاتر.
  • إعداد العناوين، المحور، الأساطير، أنماط السلسلة.
  • إدخال الصور (PNG/JPEG/BMP) مع التحكم في الموقع والحجم.

بيانات الواردات / الصادرات

  • استيراد من DataTable ، أراي، أو IEnumerable<T>.
  • وتتراوح الصادرات إلى DataTable/collections.
  • Save CSV تبادل البيانات الخفيفة.

التحقق وحماية

  • قائمة / رقم / تاريخ / قواعد التحقق المخصصة.
  • حماية ورقة العمل مع القفل الاختياري وكلمة المرور.

الأداء والذاكرة

  • يكتب البث، وتحديثات متكررة، والذاكرة المتوقعة.
  • وضع الكالسيوم اليدوي أثناء العمليات الكبيرة.
  • تتوفر على الفور (استخدام using) من أجل الموارد الحرة.

نصائح وأفضل الممارسات

  • Batch يكتب إلى نطاقات متناقضة؛ تجنب الخلايا-في-الخلاية عندما يكون ذلك ممكنا.
  • إعادة استخدام الأنماط المسمى للحد من تكرار النمط.
  • قم بتعيين وضع الحساب إلى اليدوي أثناء الواردات الكبيرة، ثم قم بإعادة التقييم مرة واحدة في النهاية.
  • تأكيد الإدخالات قبل الكتابة لتجنب الاستثناءات.
  • ضغط الصور الكبيرة قبل إدراجها للحفاظ على ملفات ناعمة.
  • إغلاق / توفير الكتب العملية لتدفق وموارد مجانية.
  • عندما تحتاج فقط إلى القيم ، فمن الأفضل ** النتائج المخفية** للتخلي عن إعادة الحساب.

FAQ

**هل أحتاج إلى Excel المثبت?**لا، المحرك مجهز بالكامل وبدون رأس.

**ما هي النماذج التي يمكنني قراءتها أو كتابتها?**هذا المعالج يركز على XLSX . للحصول على تنسيقات Excel الأوسع ( XLS، ODS) استخدم المنتج الكامل Aspose.Cells.

**هل يمكنني حساب الصيغ على جانب الخادم?**نعم - الاستخدام Workbook.CalculateFormula مع خيارات الأداء.

**ما هي حدود Excel?**يدعم XLSX ما يصل إلى 1,048,576 صف × 16,384 عمود لكل ورقة عمل.

**كيف يرتبط هذا بـ Aspose.Words?**يتم دمجها في أنابيب Words-centric (على سبيل المثال، تحويل Word→XLSX أو إرفاق خروقات XLSX) مع الاعتماد على محرك Excel المطحون داخليًا.

 عربي