Aspose.Cells 8.8.1 da Genel API Değişiklikleri

Eklenen API’lar

Yükleme için Verileri Filtrele

Aspose.Cells for .NET 8.8.1, LoadDataFilterOptions numaralandırmasını ve LoadOptions.LoadDataFilterOptions özelliğini serbest bıraktı, bu özellik, bir şablon dosyasından çalışma kitabı oluşturulurken yüklenmesi gereken veri türünü belirtmek için kullanılabilir. Yüklenen verileri filtrelemek, özellikle LightCells API’leri kullanırken özel amaçlar için performansı iyileştirebilir.

LoadDataFilterOptions numaratörü aşağıdaki seçenekleri sağlar.

  1. Sayfa içeriğinden her şeyi yüklemek için All.
  2. Sayfa içeriğinden hiçbir şeyi yüklememek için None.
  3. Hücrelerin değeri boş olanlarını yükler için CellBlank.
  4. Boolean değerlere sahip hücreleri yükler için CellBool.
  5. Değerler, formüller ve biçimlendirmeleri içeren hücre verilerini yükler için CellData.
  6. Hücre değeri hata olanları yükler için CellError.
  7. Sayısal değerlere (Tarih ve Zaman dahil) sahip hücreleri yükler için CellNumeric.
  8. Metin/dizi olan hücreleri yükler için CellString.
  9. Yalnızca hücre değerlerini (tüm tipleri) yükler için CellValue.
  10. Yalnızca grafikleri yükler için Chart.
  11. Yalnızca koşullu biçimlendirme kurallarını yükler için ConditionalFormatting.
  12. Yalnızca veri doğrulama kurallarını yükler için DataValidation.
  13. Yalnızca belge özelliklerini yükler için DocumentProperties.
  14. Tanımlanmış adları içeren formülleri yükler için Formula.
  15. Yalnızca birleştirilmiş hücreleri yükler için MergedArea.
  16. Pivot Tablolarını yükler için PivotTable.
  17. Yalnızca çalışma kitabı ve çalışma sayfası ayarlarını yükler için Settings.
  18. Yalnızca şekilleri yükler için Shape.
  19. Hücre biçimlendirmesini yükler için Style.
  20. Excel tablolarını/Liste Nesnelerini yükler için Table.

Basit kullanım senaryosu aşağıda gösterilmektedir.

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);

Doğrudan Grafikleri PDF’e Dönüştür

Aspose.Cells API’leri zaten Chart.ToPdf yöntemini kullanırken grafikleri PDF’e dönüştürme olanağı sağlamıştır. Bu sürümle birlikte, API başka bir yüklenmiş versiyonu serbest bırakmıştır ki bu versiyon Stream örneğini kabul edebilecek ve kullanıcıların grafik PDF’lerini MemoryStream örneğinde kaydetmelerine olanak sağlayacaktır.

Basit kullanım senaryosu aşağıda gösterilmektedir.

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 Özelliği Eklendi

Aspose.Cells for .NET 8.8.1, WorkbookSettings.PaperSize özelliğini serbest bırakmıştır, bu özellik, tüm elektronik tablonun varsayılan yazdırma kağıdı boyutunu ayarlamak için kabul eder. WorkbookSettings.PaperSize özelliği, en yaygın kullanılan yazdırma kağıtları türleri için önceden tanımlanmış boyutlar içeren PaperSizeType numaralandırmasından bir değeri kabul eder.

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 Özelliği Eklendi

Aspose.Cells for .NET API’nin bu sürümü, metinlerin şekillerin içindeki özelliklerini manipüle etmek için Shape.TextBody’i ortaya çıkardı. Aşağıdaki kod parçası, belirtilen özelliği kullanarak TextBox’ın içindeki metnin gölge efektini ayarlamak için kullanılır.

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) Method Eklendi

Aspose.Cells for .NET 8.8.1, CalculateFormula yöntemi için başka bir aşırı yüklemeyi ortaya çıkardı, bu da belirli seçeneklerle doğrudan belirli bir formülü hesaplama yeteneği sağlar.

GridCell.CreateValidation Method Eklendi

Aspose.Cells.GridWeb, GridCell.CreateValidation yöntemini kullanırken tek bir hücreye doğrudan doğrulama kuralı eklemek için yetenek sağladı. Söz konusu yöntem 2 parametre gerektirir. İlk parametre, doğrulama türünü belirleyen GridValidationType türündedir, ikinci parametre (isRequied) Boolean türündedir.

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 Method Eklendi

Aspose.Cells.GridWeb ayrıca GridCell.RemoveValidation yöntemini kullanarak bir GridCell’den veri doğrulama kuralını kaldırma yeteneği sağladı.

Eskimiş API’lar

Eskimiş Shape.TextFrame Özelliği

Bu yerine Shape.TextBody.TextAlignment özelliğinin kullanılması tavsiye edilir.

Aspose.Cells 8.8.0 da Genel API Değişiklikleri Aspose.Cells 8.8.2 de Genel API Değişiklikleri