Öffentlich API Änderungen in Aspose.Cells 8.7.0
APIs hinzugefügt
Unterstützung für digitales Signieren, Erkennen und Extrahieren von VBA-Projekten
Diese Version von Aspose.Cells for .NET hat einige neue Eigenschaften und Methoden bereitgestellt, um die Benutzer bei Aufgaben wie dem digitalen Signieren eines VBA-Projekts und dem Erkennen, ob ein VBA-Projekt signiert und gültig ist, zu unterstützen. Darüber hinaus ermöglicht die neue API das Extrahieren des Zertifikats als Rohdaten aus einem digital signierten VBA-Projekt in Workbook.
VBA-Projekt digital signieren
Aspose.Cells for .NET 8.7.0 hat die VbaProject.Sign-Methode verfügbar gemacht, die verwendet werden kannSignieren Sie das VBA-Projekt digital in einer Arbeitsmappe. Die genannte Methode akzeptiert eine Instanz der DigitalSignature-Klasse, die sich im Namensraum Aspose.Cells.DigitalSignatures befindet.
Es folgt das einfache Nutzungsszenario.
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));
Erkennung von digital signierten VBA-Projekten
Die neu verfügbar gemachte VbaProject.IsSigned-Eigenschaft kann verwendet werdenerkennen, ob das VBA-Projekt in einer Arbeitsmappe digital signiert ist. Die Eigenschaft VbaProject.IsSigned ist vom Typ Boolean und gibt „true“ zurück, wenn das VBA-Projekt digital signiert ist und umgekehrt.
Es folgt das einfache Nutzungsszenario.
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");
}
Extraktion der digitalen Signatur aus dem VBA-Projekt
Diese Revision von API hat auch die VbaProject.CertRawData-Eigenschaft verfügbar gemacht, die dies ermöglichtextrahieren Sie die Rohdaten des digitalen Zertifikats aus dem VBA-Projekt. Die Eigenschaft VbaProject.CertRawData ist vom Typ Byte-Array, das die Rohdaten des Zertifikats enthält, wenn das VBA-Projekt digital signiert ist, andernfalls ist die Eigenschaft null.
Es folgt das einfache Nutzungsszenario.
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;
Validieren Sie die digitale Signatur des VBA-Projekts
Eine weitere Ergänzung zum öffentlichen API ist die VbaProject.IsValidSigned-Eigenschaft, die nützlich sein könnteValidierung der digitalen Signatur des VBA-Projekts. Die genannte Eigenschaft gibt true zurück, wenn die digitale Signatur gültig ist, und false, wenn die Signatur ungültig ist.
Es folgt das einfache Nutzungsszenario.
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");
}
}
Methode Protection.VerifyPassword Hinzugefügt
Aspose.Cells for .NET 8.7.0 hat die Protection.VerifyPassword-Methode bereitgestellt, die verwendet werden kannÜberprüfen Sie das zum Schutz des Arbeitsblatts verwendete KennwortDiese Methode akzeptiert eine Zeichenfolgeninstanz als Parameter und gibt „true“ zurück, wenn das angegebene Kennwort mit dem zum Schutz des Arbeitsblatts verwendeten Kennwort übereinstimmt.
Es folgt das einfache Nutzungsszenario.
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");
}
Eigenschaftsschutz.IsProtectedWithPassword Hinzugefügt
Diese Version von Aspose.Cells for .NET API hat auch die Protection.IsProtectedWithPassword-Eigenschaft verfügbar gemacht, die nützlich sein kannErkennen, ob ein Arbeitsblatt passwortgeschützt ist oder nicht.
Es folgt das einfache Nutzungsszenario.
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");
}
Eigenschaft ColorScale.Is3ColorScale Hinzugefügt
Aspose.Cells for .NET 8.7.0 hat die Eigenschaft ColorScale.Is3ColorScale verfügbar gemacht, die zum Erstellen des bedingten Formats „2-Color Scale“ verwendet werden kann. Die genannte Eigenschaft ist vom Typ Boolean mit dem Standardwert „true“, was bedeutet, dass das bedingte Format standardmäßig eine 3-Farbskala ist. Wenn Sie jedoch die Eigenschaft ColorScale.Is3ColorScale auf false umstellen, wird dies der Fall seinGenerieren Sie ein bedingtes 2-Farbskalen-Format.
Es folgt das einfache Nutzungsszenario.
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
Eigenschaft TxtLoadOptions.HasFormula Hinzugefügt
Aspose.Cells for .NET 8.7.0 hat Unterstützung für bereitgestelltIdentifizieren und parsen Sie die Formeln beim Laden von CSV/TXT-Dateien mit getrennten Klardaten. Die neu verfügbar gemachte TxtLoadOptions.HasFormula-Eigenschaft weist, wenn sie auf „true“ gesetzt ist, den API an, die Formeln aus der Eingabedatei mit Trennzeichen zu analysieren und sie auf relevante Zellen festzulegen, ohne dass eine zusätzliche Verarbeitung erforderlich ist.
Es folgt das einfache Nutzungsszenario.
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);
Eigenschaft DataLabels.IsResizeShapeToFitText Hinzugefügt
Eine weitere nützliche Funktion, die Aspose.Cells for .NET 8.7.0 verfügbar gemacht hat, ist die DataLabels.IsResizeShapeToFitText-Eigenschaft, die die aktivieren kannPassen Sie die Größe der Form an den Text anFunktion der Excel-Anwendung für die Datenbeschriftungen des Diagramms.
Es folgt das einfache Nutzungsszenario.
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();
Eigenschaft PdfSaveOptions.OptimizationType Hinzugefügt
Aspose.Cells for .NET 8.7.0 hat die PdfSaveOptions.OptimizationType-Eigenschaft zusammen mit der PdfOptimizationType-Enumeration bereitgestellt, um Benutzern dies zu erleichternWählen Sie den gewünschten Optimierungsalgorithmus, während Sie Tabellenkalkulationen in das Format PDF exportieren. Es gibt 2 mögliche Werte für die PdfSaveOptions.OptimizationType-Eigenschaft, wie unten beschrieben.
- PdfOptimizationType.MinimumSize: Die Qualität ist für die resultierende Dateigröße beeinträchtigt.
- PdfOptimizationType.Standard: Die Qualität wird nicht beeinträchtigt, sodass die resultierende Dateigröße groß sein wird.
Es folgt das einfache Nutzungsszenario.
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);
Entfernte APIs
Eigenschaft Workbook.SaveOptions Entfernt
Die Workbook.SaveOptions-Eigenschaft wurde vor einiger Zeit als veraltet markiert. Mit dieser Version wurde es vollständig aus dem öffentlichen API entfernt, daher wird empfohlen, alternativ die Methode Workbook.Save(Stream, SaveOptions) oder Workbook.Save(string, SaveOptions) zu verwenden.