تغييرات API العامة في Aspose.Cells 8.8.1

يصف هذا المستند التغييرات في واجهة برمجة التطبيقات لـ Aspose.Cells من الإصدار 8.8.0 إلى 8.8.1 التي قد تكون مثيرة للاهتمام لمطوري الوحدات/التطبيقات. يتضمن ليس فقط الطرق العامة الجديدة والمحدثة والفئات المضافة والمحذوفة وما إلى ذلك، ولكن أيضًا وصفًا لأي تغييرات في السلوك في الخلفية في Aspose.Cells.

واجهات برمجة التطبيقات الجديدة

تصفية البيانات للتحميل

Aspose.Cells for .NET 8.8.1 قد قدمت تعدداً لتصفية بيانات LoadDataFilterOptions مع خاصية LoadOptions.LoadDataFilterOptions التي يمكن استخدامها لتحديد نوع البيانات التي يجب تحميلها عند بناء دفتر العمل من ملف نموذجي. يمكن أن تحسن عملية تحميل البيانات المصفاة الأداء في الأغراض الخاصة، خاصة عند استخدام واجهات LightCells.

تقدم تعداد LoadDataFilterOptions التالية.

1. الكل لتحميل كل شيء من جدول البيانات.
2. لا شيء للتحميل شيء من جدول البيانات.
3. CellBlank يحمل الخلايا التي تكون قيمها فارغة.
4. CellBool يحمل الخلايا التي تكون قيمها Boolean.
5. CellData يحمل بيانات الخلايا بما في ذلك القيم والصيغ والتنسيق.
6. CellError يحمل الخلايا التي تكون قيمها خطأ.
7. CellNumeric يحمل الخلايا التي تكون قيمها رقمية (بما في ذلك التاريخ والوقت).
8. CellString يحمل الخلايا التي تكون قيمها نص/سلسلة نصية.
9. CellValue يحمل قيم الخلية فقط (جميع الأنواع).
10. تحميل الرسم البياني فقط.
11. تحميل التنسيق الشرطي فقط.
12. تحميل قواعد التحقق من البيانات فقط.
13. تحميل خصائص المستند فقط.
14. تحميل الصيغ بما فيها الأسماء المحددة.
15. تحميل الخلايا المدمجة فقط.
16. تحميل الجداول المحورية فقط.
17. تحميل إعدادات دفتر العمل وورقة العمل فقط.
18. تحميل الأشكال فقط.
19. تحميل تنسيق الخلايا فقط.
20. تحميل جداول Excel/List Objects فقط.

لمزيد من التفاصيل حول هذه الميزة، يرجى مراجعة المقال المفصل حول تصفية البيانات للتحميل.

فيما يلي سيناريو الاستخدام البسيط.

C#

 //Create an instance of LoadOptions & initialize it with type of template to be loaded

var options = new LoadOptions(LoadFormat.Xlsx);

//Set LoadDataFilterOptions to load only shapes

options.LoadDataFilterOptions = LoadDataFilterOptions.Shape;

//Create an instance of Workbook from a existing spreadsheet using instance of LoadOptions

var book = new Workbook(filePath, options);

تحويل مباشر للرسم البياني إلى PDF

لقد قدمت واجهات برمجة التطبيقات Aspose.Cells بالفعل إمكانية عرض الرسوم البيانية إلى PDF أثناء استخدام الطريقة Chart.ToPdf. مع هذا الإصدار، قد فتحت الواجهة برمجة التطبيقات الإصدارة نسخة أخرى من الطريقة المذكورة التي يمكن أن تقبل مثيلًا لمجرى بيانات، مما يتيح للمستخدمين حفظ PDF الرسم البياني في مثيل من MemoryStream.

فيما يلي سيناريو الاستخدام البسيط.

C#

 //Create an instance of Workbook and load an existing spreadsheet with a chart

var workbook = new Workbook(filePath);

//Access first worksheet containing a chart

var worksheet = workbook.Worksheets[0];

//Access first chart from the worksheet

var chart = worksheet.Charts[0];

//Save the chart to PDF as Stream

using (MemoryStream stream = new MemoryStream())

{

    chart.ToPdf(stream);

}

تمت إضافة خاصية WorkbookSettings.PaperSize

أضافت الإصدارة Aspose.Cells for .NET 8.8.1 خاصية WorkbookSettings.PaperSize من أجل تعيين حجم الورق الافتراضي للطباعة لجدول البيانات بأكمله. تقبل خاصية WorkbookSettings.PaperSize قيمة من تعداد PaperSizeType الذي يحتوي على الأحجام المحددة مسبقًا لأكثر أنواع الورق للاستخدام في الطباعة.

C#

 //Create an instance of Workbook

//Optionally load an existing spreadsheet

var book = new Workbook();

//Access WorkbookSettings from the Workbook

var settings = book.Settings;

//Set the default printing paper size for the Workbook

settings.PaperSize = PaperSizeType.PaperA4;

تمت إضافة خاصية Shape.TextBody

أضاف هذا الإصدار من Aspose.Cells for .NET واجهة برمجة التطبيقات خاصية Shape.TextBody من أجل التلاعب بجوانب النص في الأشكال. تستخدم الكود البرمجي التالي الخاصية المذكورة لضبط تأثير الظل للنص في مربع النص.

لمزيد من التفاصيل حول هذه الميزة، يرجى مراجعة المقال المفصل حول ضبط تأثير الظل على النص.

C#

 //Create an instance of Workbook

var book = new Workbook();

//Access first worksheet of the Workbook

var sheet = book.Worksheets[0];

//Add a TextBox to the ShapeCollection

var textBox = sheet.Shapes.AddTextBox(2, 0, 2, 0, 100, 400);

//Set the text of the TextBox

textBox.Text = "This text has the following settings.\n\nText Effects > Shadow > Offset Bottom";

//Set shadow effect for text

for (int i = 0; i < textBox.TextBody.Count; i++)

{

    textBox.TextBody[i].ShapeFont.FillFormat.ShadowEffect.PresetType = PresetShadowType.OffsetBottom;

}

تمت إضافة أسلوب Worksheet.CalculateFormula(string formula, CalculationOptions opts)

قد عرض الإصدار Aspose.Cells for .NET 8.8.1 حملة تحميل أخرى للطريقة CalculateFormula تقدم القدرة على حساب صيغة معينة مباشرة مع خيارات مخصصة.

لمزيد من التفاصيل حول هذه الميزة، يرجى مراجعة المقال المفصل حول الحساب المباشر للدالة المخصصة.

تمت إضافة أسلوب GridCell.CreateValidation

قدم Aspose.Cells.GridWeb القدرة على إضافة قاعدة التحقق إلى خلية واحدة مباشرةً باستخدام أسلوب GridCell.CreateValidation. يتطلب الأسلوب المذكور معلمتين. الأولى من نوع GridValidationType التي تحدد نوع التحقق، في حين أن المعلمة الثانية (isRequied) هي من نوع بوليان.

C#

 //Access first worksheet

GridWorksheet sheet = GridWeb1.WorkSheets[0];

//Access cell B3

GridCell cell = sheet.Cells["B3"];

//Add validation inside the GridCell

//Any value which is not between 20 and 40 will cause error in a GridCell

GridValidation val = cell.CreateValidation(GridValidationType.WholeNumber, true);

val.Formula1 = "=20";

val.Formula2 = "=40";

val.Operator = GridOperatorType.Between;

val.ShowError = true;

val.ShowInput = true;

تمت إضافة أسلوب GridCell.RemoveValidation

قدم Aspose.Cells.GridWeb أيضًا القدرة على إزالة قاعدة التحقق من GridCell باستخدام أسلوب GridCell.RemoveValidation.

واجهات برمجة التطبيق القديمة

تمت إهمال خاصية Shape.TextFrame

يُنصح باستخدام خاصية Shape.TextBody.TextAlignment بدلاً منها.