Aspose.Cells FOSS
.NET
الأسئلة المتكررة

الأسئلة المتكررة

الأسئلة المتكررة

الترخيص والمصدر المفتوح

ما هو الترخيص لـ Aspose.Cells FOSS لـ .NET؟

Aspose.Cells FOSS for .NET تم نشره تحت رخصة MIT. أنت حر في استخدام المكتبة، نسخها، تعديلها، وتوزيعها في أي مشروع — بما في ذلك البرمجيات التجارية — دون رسوم ملكية أو متطلبات إسناد تتجاوز إشعار الترخيص. الكود المصدري متاح على github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-NET.

هل يمكنني استخدام Aspose.Cells FOSS لـ .NET في منتج تجاري؟

نعم. رخصة MIT تسمح بالاستخدام التجاري غير المقيد. لا توجد حدود للمقاعد أو رسوم تشغيل أو متطلبات اشتراك.

هل هذا هو نفسه Aspose.Cells التجاري لـ .NET؟

لا. Aspose.Cells FOSS هي مكتبة مفتوحة المصدر منفصلة ومستقلة. تدعم القراءة/الكتابة بصيغة XLSX فقط. تدعم النسخة التجارية من Aspose.Cells لـ .NET العديد من الصيغ الإضافية (XLS، ODS، PDF، HTML، إلخ) والميزات التي تقع خارج نطاق إصدار FOSS هذا.

التثبيت والمتطلبات

كيف أقوم بتثبيت Aspose.Cells FOSS لـ .NET؟

التثبيت عبر واجهة سطر أوامر dotnet:

dotnet add package Aspose.Cells_FOSS

أو من خلال Visual Studio Package Manager Console:

Install-Package Aspose.Cells_FOSS

ما إصدارات .NET المدعومة؟

.NET 6.0 أو أحدث (.NET 8.0 LTS يُنصح به). المكتبة هي شفرة مُدارة بحتة ولا تستهدف .NET Framework.

هل هناك أي تبعيات أصلية؟

لا. Aspose.Cells FOSS for .NET هو كود مُدار نقي بدون COM أو P/Invoke أو Office Interop أو تبعيات مكتبة أصلية. يعمل على Windows و macOS و Linux و Docker و بيئات بدون خادم.

دعم الصيغ

ما هي صيغ الملفات التي يمكن لـ Aspose.Cells FOSS لـ .NET قراءتها وكتابتها؟

الصيغةالامتدادقراءةكتابة
Xlsx.xlsx✓✓

هل يمكن للمكتبة قراءة أو كتابة ملفات CSV أو XLS أو ODS أو PDF؟

لا. يدعم هذا الإصدار فقط XLSX (Open XML). CSV، XLS الثنائي، ODS، PDF، HTML، وتصدير الصور غير متوفر.

هل يمكنني تحميل ملف XLSX تالف قليلاً؟

نعم. مرّر كائن LoadOptions مع TryRepairPackage = true و TryRepairXml = true إلى مُنشئ Workbook. ستحاول المكتبة استعادة الملف. يتم إلقاء WorkbookLoadException إذا كان الملف غير قابل للاسترداد.

using Aspose.Cells_FOSS;

var opts = new LoadOptions { TryRepairPackage = true, TryRepairXml = true };
var wb = new Workbook("file.xlsx", opts);
Console.WriteLine("Repairs applied: " + wb.LoadDiagnostics.HasRepairs);

استخدام API

كيف أنشئ دفتر عمل جديد وأكتب بيانات الخلية؟

إنشاء Workbook، الوصول إلى ورقة العمل الأولى عبر Workbook.Worksheets[0]، واستدعاء Cell.PutValue() لكتابة البيانات. احفظ باستخدام Workbook.Save(path).

using Aspose.Cells_FOSS;

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

ws.Cells["A1"].PutValue("Name");
ws.Cells["B1"].PutValue("Score");
ws.Cells["A2"].PutValue("Alice");
ws.Cells["B2"].PutValue(95);
ws.Cells["C2"].Formula = "=B2*1.1";

wb.Save("output.xlsx");

كيف أقرأ قيم الخلايا من ملف XLSX موجود؟

مرّر مسار الملف إلى مُنشئ Workbook واقرأ قيم الخلايا عبر Cell.StringValue (سلسلة عرض) أو Cell.Value (كائن .NET الخام).

using Aspose.Cells_FOSS;

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

Console.WriteLine(ws.Cells["A2"].StringValue);  // Alice
Console.WriteLine(ws.Cells["B2"].StringValue);  // 95
Console.WriteLine(ws.Cells["C2"].Formula);       // =B2*1.1

كيف يمكنني تطبيق التنسيق على خلية؟

استدعِ Cell.GetStyle() لاسترجاع Style الحالي، عدّل الخصائص، واستدعِ Cell.SetStyle(style) لتطبيقها.

using Aspose.Cells_FOSS;

var wb = new Workbook();
var cell = wb.Worksheets[0].Cells["A1"];
cell.PutValue("Header");

var style = cell.GetStyle();
style.Font.Bold = true;
style.Font.Size = 14;
style.Pattern = FillPattern.Solid;
style.ForegroundColor = System.Drawing.Color.FromArgb(255, 198, 239, 206);
style.HorizontalAlignment = HorizontalAlignmentType.Center;
cell.SetStyle(style);

wb.Save("styled.xlsx");

كيف أضيف ورقة عمل جديدة؟

استدعِ Workbook.Worksheets.Add(name). تُعيد الطريقة الفهرس الصحيح للورقة الجديدة؛ استخدمه للوصول إلى كائن الورقة.

using Aspose.Cells_FOSS;

var wb = new Workbook();
wb.Worksheets[0].Name = "Summary";
var dataIdx = wb.Worksheets.Add("Data");
wb.Worksheets[dataIdx].Cells["A1"].PutValue("Data sheet");
wb.Save("multi.xlsx");

كيف يمكنني إضافة التحقق من صحة البيانات إلى نطاق خلايا؟

الوصول إلى Worksheet.Validations، استدعِ Add(CellArea) لإنشاء Validation، ثم اضبط Type الخاص به باستخدام ValidationType.

using Aspose.Cells_FOSS;

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

var val = ws.Validations[ws.Validations.Add(CellArea.CreateCellArea("A1", "A10"))];
val.Type = ValidationType.List;
val.Formula1 = "\"Open,Closed,Pending\"";
val.InCellDropDown = true;

wb.Save("validated.xlsx");

القيود المعروفة

ما هي الميزات غير المدعومة؟

العناصر التالية خارج نطاق Aspose.Cells FOSS الحالي لـ .NET:

  • صيغ غير XLSX (لا XLS، CSV، ODS، PDF، HTML، أو تصدير صور)
  • جداول محورية ومخططات محورية
  • ماكرو VBA
  • مخططات شرارة
  • نص غني داخل خلية واحدة (تشغيل خطوط مختلطة)

هل تدعم المكتبة إعادة حساب الصيغ؟

يتم تخزين سلاسل الصيغ واسترجاعها كما هي. تُقرأ القيم المحسوبة من النتيجة المخزنة مؤقتًا في ملف XLSX. لا تقوم المكتبة بإعادة حساب الصيغ على الخادم — يتم إعادة حساب الصيغة بواسطة Excel أو تطبيق متوافق عند الفتح.

هل يمكنني حماية مصنف بكلمة مرور؟

الحماية على مستوى ورقة العمل متاحة عبر Worksheet.Protect() و Worksheet.Protection. تشفير كلمة مرور على مستوى المصنف غير موجود في واجهة برمجة التطبيقات الحالية.

 العربية