تغييرات واجهة برمجة التطبيقات العامة في Aspose.Cells 16.11.0

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

دعم إعدادات العولمة

أصدر Aspose.Cells 16.11.0 فئة GlobalizationSettings إلى جانب خاصية WorkbookSettings.GlobalizationSettings لفرض استخدام واجهات برمجة التطبيقات لـ Aspose.Cells لاستخدام تسميات مخصصة لإجمالي الأرقام الفرعية. تحتوي فئة GlobalizationSettings على الطرق التالية التي يمكن استبدالها في التنفيذ المخصص لإعطاء أسماء مرغوبة للتسميات الإجمالي والإجمالي الكلي.

  • GlobalizationSettings.GetTotalName: يحصل على اسم المجموع.
  • GlobalizationSettings.GetGrandTotalName: يحصل على اسم الإجمالي الكبرى للوظيفة.

فيما يلي فئة مخصصة بسيطة توسع فئة GlobalizationSettings وتستبدل طرقها المذكورة أعلاه لإرجاع تسميات مخصصة لدالة التجميع المتوسطية.

C#

 class CustomSettings : GlobalizationSettings

{

    public override string GetTotalName(ConsolidationFunction functionType)

    {

        switch (functionType)

        {

            case ConsolidationFunction.Average:

                return "AVG";

            default:

                return base.GetTotalName(functionType);

        }

    }

    public override string GetGrandTotalName(ConsolidationFunction functionType)

    {

        switch (functionType)

        {

            case ConsolidationFunction.Average:

                return "GRD AVG";

            default:

                return base.GetGrandTotalName(functionType);

        }

    }

}

تحميل المقتطف التالي ورقة عمل موجودة بالفعل ويضيف Subtotal من النوع المتوسط على البيانات المتاحة بالفعل في ورقة العمل. سيتم استدعاء فئة CustomSettings وأساليب GetTotalName و GetGrandTotalName في وقت إضافة Subtotal إلى ورقة العمل.

C#

 // Loads an existing spreadsheet containing some data

Workbook book = new Workbook(dir + "sample.xlsx");

// Assigns the GlobalizationSettings property of the WorkbookSettings class

// to the class created in first step

book.Settings.GlobalizationSettings = new Cells.CustomSettings();

// Accesses the 1st worksheet from the collection which contains data

// Data resides in the cell range A2:B9

Worksheet sheet = book.Worksheets[0];

// Adds SubTotal of type Average to the worksheet

sheet.Cells.Subtotal(CellArea.CreateCellArea("A2", "B9"), 0, ConsolidationFunction.Average, new int[] { 0,1 });

// Calculates Formulas

book.CalculateFormula();

// Auto fits all columns

sheet.AutoFitColumns();

// Saves the workbook on disc

book.Save(dir + "output.xlsx");

تقدم فئة GlobalizationSettings أيضًا أسلوب GetOtherName والذي يعد مفيدًا للحصول على اسم “آخر” للرسوم البيانية الدائرية. هنا سيناريو استخدام بسيط لأسلوب GlobalizationSettings.GetOtherName.

C#

 class CustomSettings : GlobalizationSettings

{

    public override string GetOtherName()

    {

        int lcid = System.Globalization.CultureInfo.CurrentCulture.LCID;

        switch (lcid)

        {

            case 1033:

                return "Other";

            case 1036:

                return "Autre";

            case 1031:

                return "Andere";

            //Do other case

            default:

                return base.GetOtherName();

        }

    }

}

المقتطف التالي يقوم بتحميل جدول بيانات موجود يحتوي على رسم بياني دائري، ويقوم بتقديم الرسم البياني إلى صورة أثناء استخدام فئة CustomSettings التي تم إنشاؤها أعلاه.

C#

 // Loads an existing spreadsheet containing a pie chart

Workbook book = new Workbook(dir + "sample.xlsx");

// Assigns the GlobalizationSettings property of the WorkbookSettings class

// to the class created in first step

book.Settings.GlobalizationSettings = new Cells.CustomSettings();

// Accesses the 1st worksheet from the collection which contains pie chart

Worksheet sheet = book.Worksheets[0];

// Accesses the 1st chart from the collection

Chart chart = sheet.Charts[0];

// Refreshes the chart

chart.Calculate();

// Renders the chart to image

chart.ToImage(dir + "output.png", new ImageOrPrintOptions());

تمت إضافة فئة CellsFactory

Aspose.Cells 16.11.0 قد عرضت فئة CellsFactory التي تحتوي حاليًا على طريقة واحدة، وهي؛ CreateStyle. يمكن استخدام طريقة CellsFactory.CreateStyle لإنشاء مثيل لفئة Style دون إضافته إلى مجموعة أنماط دفتر العمل.

هنا سيناريو استخدام بسيط لطريقة CellsFactory.CreateStyle.

C#

 // Initializes the CellsFactory class

CellsFactory factory = new CellsFactory();

// Creates an instance of Style

Style style = factory.CreateStyle();

تمت إضافة خاصية Workbook.AbsolutePath

أصدر Aspose.Cells 16.11.0 خاصية Workbook.AbsolutePath التي تسمح بالحصول على مسار العمل المؤقت المخزن في ملف workbook.xml أو تعيينه. تعتبر هذه الخاصية مفيدة أثناء تحديث الروابط الخارجية فقط.

قد عرض Aspose.Cells.GridWeb 16.11.0 طريقة GetHyperlink إلى فئة GridHyperlinkCollection التي تسمح بالحصول على مثيل من GridHyperlink سواء عن طريق تمرير مثيل GridCell أو زوج من الأعداد الصحيحة المقابلة لفهار الصف العمود.

هنا سيناريو استخدام بسيط لطريقة GetHyperlink.

C#

 // Gets the active worksheet from the collection

GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Accesses the GridHyperlinkCollection

GridHyperlinkCollection links = sheet.Hyperlinks;

// Gets hyperlink from cell A1

GridHyperlink link = links.GetHyperlink(sheet.Cells["A1"]);

// Gets hyperlink from cell D1

link = links.GetHyperlink(0, 3);

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

مُنشئ نمط مهجور

يرجى استخدام طريقة cellsFactory.CreateStyle كبديل.

حذف واجهات برمجة التطبيق

الاكتشاف الشعبي للخلية.

يرجى استخدام طريقة Cell.GetConditionalFormattingResult بدلاً من طريقة GetConditionalStyle.

طريقة حذف الخلايا.حدث الصف الأقصى في العمود(int column)

يرجى استخدام طريقة Cells.GetLastDataRow(int) كبديل.

خاصية Draft في PageSetup تم حذفها

من المستحسن استخدام خاصية PrintDraft في PageSetup بدلاً من ذلك.

خاصية FilterColumnCollection في AutoFilter تم حذفها

يرجى النظر في استخدام خاصية FilterColumns في AutoFilter لتحقيق نفس الهدف.

خاصية Rotation في TickLabels تم حذفها

الرجاء استخدام خاصية RotationAngle في TickLabels بدلاً من ذلك.