Genel API Aspose.Cells 8.8.1'deki değişiklikler

Eklenen API’ler

Yükleme için Verileri Filtrele

Aspose.Cells for .NET 8.8.1, bir şablon dosyasından çalışma kitabı oluşturulurken yüklenmesi gereken veri türünü belirtmek için kullanılabilen LoadOptions.LoadDataFilterOptions özelliğiyle birlikte LoadDataFilterOptions numaralandırmasını kullanıma sundu. Yüklenen verileri filtrelemek, özellikle LightCells API’lerini kullanırken özel amaçlar için performansı iyileştirebilir.

LoadDataFilterOptions numaralandırması aşağıdaki seçimleri sağlar.

  1. Elektronik tablodan her şeyi yüklemek için Tümü.
  2. E-tablodan hiçbir şey yüklemek için Yok.
  3. CellBlank, değerleri boş olan hücreleri yükler.
  4. CellBool, değerleri Boolean olan hücreleri yükler.
  5. CellData, değerler, formüller ve biçimlendirme dahil olmak üzere hücre verilerini yükler.
  6. CellError, değerleri hatalı olan hücreleri yükler.
  7. CellNumeric, değerleri sayısal olan (Tarih ve Saat dahil) hücreleri yükler.
  8. CellString, değerleri metin/dize olan hücreleri yükler.
  9. CellValue yalnızca hücre değerlerini (tüm türler) yükler.
  10. Grafik yalnızca çizelgeleri yükler.
  11. Koşullu Biçimlendirme yalnızca koşullu biçimlendirme kurallarını yükler.
  12. DataValidation yalnızca veri doğrulama kurallarını yükler.
  13. DocumentProperties yalnızca belge özelliklerini yükler.
  14. Formül, tanımlı adlar dahil olmak üzere formülleri yükler.
  15. MergedArea yalnızca birleştirilmiş hücreleri yükler.
  16. PivotTable, Pivot Tabloları yükler.
  17. Ayarlar yalnızca Çalışma Kitabı ve Çalışma Sayfası ayarlarını yükler.
  18. Şekil yalnızca şekilleri yükler.
  19. Stil, hücre biçimlendirmesini yükler.
  20. Tablo, Excel tablolarını/Liste Nesnelerini yükler.

Basit kullanım senaryosu aşağıdadır.

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

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

Aspose.Cells API’leri, Chart.ToPdf yöntemini kullanırken grafikleri PDF’e işleme olanağı sağladı. Bu sürümle birlikte API, söz konusu yöntemin bir Stream örneğini kabul edebilen başka bir aşırı yüklenmiş sürümünü ortaya çıkardı ve kullanıcıların grafiğin PDF’ini bir MemoryStream örneğine kaydetmesine izin verdi.

Basit kullanım senaryosu aşağıdadır.

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, tüm elektronik tablo için varsayılan baskı kağıdı boyutunu ayarlamak üzere WorkbookSettings.PaperSize özelliğini kullanıma sundu. WorkbookSettings.PaperSize özelliği, en yaygın kullanılan yazdırma kağıdı türleri için önceden tanımlanmış boyutları içeren PaperSizeType numaralandırmasından bir değer 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’in bu sürümü, şekillerdeki metnin özelliklerini değiştirmek için Shape.TextBody’yi ortaya çıkardı. Aşağıdaki kod parçacığı, bir TextBox’taki metnin gölge efektini ayarlamak için söz konusu özelliği kullanır.

C#

 //Çalışma Kitabının bir örneğini oluştur

var kitap = yeni Çalışma Kitabı();

//Çalışma Kitabının ilk çalışma sayfasına erişin

var sayfası = kitap.Çalışma Sayfaları[0];

//ShapeCollection'a bir Metin Kutusu ekleyin

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

//TextBox'ın metnini ayarla

textBox.Text = "Bu metin aşağıdaki ayarlara sahiptir.\n\nMetin Efektleri > Gölge > Alttan Kaydır";

//Metin için gölge efekti ayarla

 için (int ben = 0; ben< textBox.TextBody.Count; i++)

{

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

}

Worksheet.CalculateFormula(dize formülü, CalculationOptions opts) Yöntemi Eklendi

Aspose.Cells for .NET 8.8.1, belirli bir formülü doğrudan özel seçeneklerle hesaplama yeteneği sağlayan CalculateFormula yöntemi için başka bir aşırı yüklemeye maruz kaldı.

GridCell.CreateValidation Yöntemi Eklendi

Aspose.Cells.GridWeb, GridCell.CreateValidation yöntemini kullanırken doğrulama kuralını doğrudan tek bir hücreye ekleme olanağı sağlamıştır. Bahsedilen yöntem 2 parametre gerektirir. Birincisi, doğrulama türünü belirleyen GridValidationType türündeyken, 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 Yöntemi Eklendi

Aspose.Cells.GridWeb, GridCell.RemoveValidation yöntemini kullanırken bir GridCell’den veri doğrulama kuralını kaldırma olanağı da sağlamıştır.

Eski API’ler

Eski Shape.TextFrame Özelliği

Bunun yerine Shape.TextBody.TextAlignment özelliğinin kullanılması önerilir.