Genel API Aspose.Cells 8.7.0'daki değişiklikler
Eklenen API’ler
VBA Projesi Dijital İmzalama, Algılama ve Çıkarma Desteği
Aspose.Cells for .NET numaralı bu sürüm, kullanıcılara bir VBA projesini dijital olarak imzalama, bir VBA projesinin imzalanıp imzalanmadığını ve geçerli olup olmadığını belirleme gibi görevlerde yardımcı olacak bazı yeni özellikler ve yöntemler ortaya çıkardı. Ayrıca yeni API, sertifikanın Workbook’ta dijital olarak imzalanmış VBA projesinden ham veri olarak çıkarılmasına izin verir.
VBA Projesini Dijital Olarak İmzalayın
Aspose.Cells for .NET 8.7.0, kullanılabilecek VbaProject.Sign yöntemini kullanıma sundu.VBA projesini bir Çalışma Kitabında dijital olarak imzalayın. Bahsedilen yöntem, Aspose.Cells.DigitalSignatures ad alanında bulunan DigitalSignature sınıfının bir örneğini kabul eder.
Basit kullanım senaryosu aşağıdadır.
C#
//Create an instance of Workbook
//Optionally load an existing spreadsheet
var book = new Workbook();
//Access the VbaProject from the Workbook
var vbaProject = book.VbaProject;
//Sign the VbaProject using the X509Certificate
vbaProject.Sign(new DigitalSignature(new System.Security.Cryptography.X509Certificates.X509Certificate2(cert), "Comments", DateTime.Now));
Dijital Olarak İmzalanmış VBA Projesinin Tespiti
Yeni ortaya çıkan VbaProject.IsSigned özelliği,Çalışma Kitabındaki VBA projesinin dijital olarak imzalanıp imzalanmadığını tespit edin. VbaProject.IsSigned özelliği Boolean türündedir ve VBA projesi dijital olarak imzalanmışsa veya tersi geçerliyse doğru değerini döndürür.
Basit kullanım senaryosu aşağıdadır.
C#
//Create an instance of Workbook and load an existing spreadsheet
var book = new Workbook(inFilePath);
//Access the VbaProject from the Workbook
var vbaProject = book.VbaProject;
//Check if VbaProject is digitally signed
if (vbaProject.IsSigned)
{
Console.WriteLine("VbaProject is digitally signed");
}
else
{
Console.WriteLine("VbaProject is not digitally signed");
}
VBA Projesinden Dijital İmza Çıkarma
API’in bu revizyonu, aşağıdakilere izin veren VbaProject.CertRawData özelliğini de ortaya çıkardı.dijital sertifikanın ham verilerini VBA projesinden çıkarın. VbaProject.CertRawData özelliği, VBA projesi dijital olarak imzalanmışsa ham sertifika verilerini içerecek bayt dizisi türündedir, aksi takdirde söz konusu özellik boş olacaktır.
Basit kullanım senaryosu aşağıdadır.
C#
//Create an instance of Workbook and load an existing spreadsheet
var book = new Workbook(inFilePath);
//Access the VbaProject from the Workbook
var vbaProject = book.VbaProject;
//Extract digital signature in an array of bytes
var cert = vbaProject.CertRawData;
VBA Projesinin Dijital İmzasını Doğrulayın
Genel API’e bir başka ekleme de yararlı olabilecek VbaProject.IsValidSigned özelliğidir.VBA projesinin dijital imzasının doğrulanması. Söz konusu özellik, dijital imza geçerliyse true, geçersizse false döndürür.
Basit kullanım senaryosu aşağıdadır.
C#
//Create an instance of Workbook and load an existing spreadsheet
var book = new Workbook(inFilePath);
//Access the VbaProject from the Workbook
var vbaProject = book.VbaProject;
//Check if VbaProject is digitally signed
if (vbaProject.IsSigned)
{
//Check if signature is valid
if (vbaProject.IsValidSigned)
{
Console.WriteLine("VbaProject is digitally signed & signature is valid");
}
}
Yöntem Protection.VerifyPassword Eklendi
Aspose.Cells for .NET 8.7.0, şu işlemler için kullanılabilecek Protection.VerifyPassword yöntemini kullanıma sunduÇalışma Sayfasını korumak için kullanılan parolayı doğrulayınBu yöntem, bir dize örneğini parametre olarak kabul eder ve belirtilen parola, Çalışma Sayfasını korumak için kullanılan parolayla eşleşirse true değerini döndürür.
Basit kullanım senaryosu aşağıdadır.
C#
//Create an instance of Workbook and load an existing spreadsheet
var book = new Workbook(inFilePath);
//Access the desired Worksheet via its index or name
var sheet = book.Worksheets[0];
//Access Protection module of desired Worksheet
var protection = sheet.Protection;
//Verify the password for Worksheet
if (protection.VerifyPassword(password))
{
Console.WriteLine("Password has matched");
}
else
{
Console.WriteLine("Password did not match");
}
Property Protection.IsProtectedWithPassword Eklendi
Aspose.Cells for .NET API’in bu sürümü, şu alanlarda yararlı olabilecek Protection.IsProtectedWithPassword özelliğini de kullanıma sunmuştur.bir Çalışma Sayfasının parola korumalı olup olmadığını tespit etme.
Basit kullanım senaryosu aşağıdadır.
C#
//Create an instance of Workbook and load an existing spreadsheet
var book = new Workbook(inFilePath);
//Access the desired Worksheet via its index or name
var sheet = book.Worksheets[0];
//Access Protection module of desired Worksheet
var protection = sheet.Protection;
//Check if Worksheet is password protected
if (protection.IsProtectedWithPassword)
{
Console.WriteLine("Worksheet is password protected");
}
else
{
Console.WriteLine("Worksheet is not password protected");
}
Özellik ColorScale.Is3ColorScale Eklendi
Aspose.Cells for .NET 8.7.0, 2-Renk Ölçeği koşullu biçimi oluşturmak için kullanılabilecek ColorScale.Is3ColorScale özelliğini ortaya çıkardı. Bahsedilen özellik, varsayılan değeri true olan Boolean türündedir; bu, koşullu formatın varsayılan olarak 3-Renk Ölçeği olacağı anlamına gelir. Ancak, ColorScale.Is3ColorScale özelliğinin yanlış olarak değiştirilmesi,2 Renkli Ölçekli bir koşullu format oluşturun.
Basit kullanım senaryosu aşağıdadır.
C#
//Create an instance of Workbook
//Optionally load an existing spreadsheet
var book = new Workbook();
//Access the Worksheet to which conditional formatting rule has to be added
var sheet = book.Worksheets[0];
//Add FormatConditions to the collection
int index = sheet.ConditionalFormattings.Add();
//Access newly added formatConditionCollection via its index
var formatConditionCollection = sheet.ConditionalFormattings[index];
//Create a CellArea on which conditional formatting rule will be applied
var cellArea = CellArea.CreateCellArea("A1", "A5");
//Add conditional formatted cell range
formatConditionCollection.AddArea(cellArea);
//Add format condition of type ColorScale
index = formatConditionCollection.AddCondition(FormatConditionType.ColorScale);
//Access newly added format condition via its index
var formatCondition = formatConditionCollection[index];
//Set Is3ColorScale to false in order to generate a 2-Color Scale format
formatCondition.ColorScale.Is3ColorScale = false;
//Set other necessary properties
Özellik TxtLoadOptions.HasFormula Eklendi
Aspose.Cells for .NET 8.7.0 desteği sağladısınırlandırılmış düz verilere sahip CSV/TXT dosyaları yüklenirken formülleri tanımlayın ve ayrıştırın. Yeni kullanıma sunulan TxtLoadOptions.HasFormula özelliği true olarak ayarlandığında, API’i formülleri girişle ayrılmış dosyadan ayrıştırmaya ve herhangi bir ek işlem gerektirmeden ilgili hücrelere ayarlamaya yönlendirir.
Basit kullanım senaryosu aşağıdadır.
C#
//Create an instance of TxtLoadOptions
var options = new TxtLoadOptions();
//Set HasFormula property to true
options.HasFormula = true;
//Set the Separator property as desired
options.Separator = ',';
//Load the CSV/TXT file using the instance of TxtLoadOptions
var book = new Workbook(inFilePath, options);
//Calculate formulas in order to get the calculated values of formula in CSV
book.CalculateFormula();
//Write result in any of the supported formats
book.Save(outFilePath);
Özellik DataLabels.IsResizeShapeToFitText Eklendi
Aspose.Cells for .NET 8.7.0’ın kullanıma sunduğu bir başka kullanışlı özellik de şu özelliği etkinleştirebilen DataLabels.IsResizeShapeToFitText özelliğidir.Metni sığdırmak için şekli yeniden boyutlandırmagrafiğin veri etiketleri için Excel uygulamasının özelliği.
Basit kullanım senaryosu aşağıdadır.
C#
//Create an instance of Workbook containing the Chart
var book = new Workbook(inFilePath);
//Access the Worksheet that contains the Chart
var sheet = book.Worksheets[0];
//Access the desired Chart via its index or name
var chart = sheet.Charts[0];
//Access the DataLabels of desired NSeries
var labels = chart.NSeries[0].DataLabels;
//Set ResizeShapeToFitText property to true
labels.IsResizeShapeToFitText = true;
//Calculate Chart
chart.Calculate();
Özellik PdfSaveOptions.OptimizationType Eklendi
Aspose.Cells for .NET 8.7.0, kullanıcıların şunları yapmasını kolaylaştırmak için PdfSaveOptions.OptimizationType özelliğini ve PdfOptimizationType numaralandırmasını kullanıma sundu.e-tabloları PDF formatına dışa aktarırken istenen optimizasyon algoritmasını seçin. PdfSaveOptions.OptimizationType özelliği için aşağıda ayrıntıları verilen 2 olası değer vardır.
- PdfOptimizationType.MinimumSize: Ortaya çıkan dosya boyutu için kaliteden ödün verilir.
- PdfOptimizationType.Standard: Kaliteden ödün verilmez, bu nedenle ortaya çıkan dosya boyutu büyük olur.
Basit kullanım senaryosu aşağıdadır.
C#
//Create an instance of PdfSaveOptions
var pdfSaveOptions = new PdfSaveOptions();
//Set the OptimizationType property to desired value
pdfSaveOptions.OptimizationType = PdfOptimizationType.MinimumSize;
//Create an instance of Workbook
//Optionally load an existing spreadsheet
var book = new Workbook(inFilePath);
//Save the spreadsheet in PDF format while passing the instance of PdfSaveOptions
book.Save(outFilePath, pdfSaveOptions);
Kaldırılan API’ler
Workbook.SaveOptions Özelliği Kaldırıldı
Workbook.SaveOptions özelliği bir süre önce geçersiz olarak işaretlendi. Bu sürümle birlikte, genel kullanımdan tamamen kaldırıldı API bu nedenle alternatif olarak Workbook.Save(Stream, SaveOptions) veya Workbook.Save(string, SaveOptions) yönteminin kullanılması tavsiye edilir.