Öffentlich API Änderungen in Aspose.Cells 8.4.1

Dieses Dokument beschreibt die Änderungen an Aspose.Cells API von Version 8.4.0 zu 8.4.1, die für Modul-/Anwendungsentwickler von Interesse sein könnten. Es enthält nicht nur neue und aktualisierte öffentliche Methoden,zusätzliche Klassen usw. undKlassen entfernt usw., sondern auch eine Beschreibung etwaiger Verhaltensänderungen hinter den Kulissen in Aspose.Cells.

APIs hinzugefügt

Mechanismus zum Ändern der Datenbankverbindung

Die Klasse Aspose.Cells.ExternalConnections.ExternalConnection enthielt bereits die Methode und die Eigenschaften, die verwendet werden konnten, um die in einer Tabelle gespeicherten Datenbankverbindungsdetails zu überprüfen. Die meisten Eigenschaften, die der Klasse Aspose.Cells.ExternalConnections.ExternalConnection zugeordnet sind, waren bis zur Veröffentlichung von Aspose.Cells for .NET 8.4.1 schreibgeschützt. Mit dieser Version hat die API die Unterstützung bereitgestellt, um auch die Datenbankverbindungseinstellungen zu manipulieren.

Das folgende Code-Snippet zeigt, wie Datenbankverbindungseinstellungen dynamisch geändert werden.

 //Create workbook object

Aspose.Cells.Workbook workbook = new Aspose.Cells.Workbook(input);

//Access first data connection

Aspose.Cells.ExternalConnections.ExternalConnection conn = workbook.DataConnections[0];

//Change a few properties

conn.Name = "MyConnectionName";

conn.OdcFile = "MyDefaulConnection.odc";

conn.ConnectionDescription = "Test Connection";

conn.Credentials = Aspose.Cells.ExternalConnections.CredentialsMethodType.Prompt;

//Save the workbook

workbook.Save(output);

Hier sind einige der wichtigsten Eigenschaften, die von der Klasse {Aspose.Cells.ExternalConnections.ExternalConnection}} verfügbar gemacht werden.

Name des Anwesens	Beschreibung
HintergrundAktualisieren	Gibt an, ob die Verbindung im Hintergrund (asynchron) aktualisiert werden kann. true, wenn die bevorzugte Verwendung der Verbindung die asynchrone Aktualisierung im Hintergrund ist; false, wenn die bevorzugte Verwendung der Verbindung die synchrone Aktualisierung im Vordergrund ist.
Verbindungsbeschreibung	Gibt die Benutzerbeschreibung für diese Verbindung an
ConnectionId	Gibt den eindeutigen Bezeichner dieser Verbindung an.
Referenzen	Gibt die Authentifizierungsmethode an, die beim Herstellen (oder Wiederherstellen) der Verbindung verwendet werden soll.
Ist gelöscht	Gibt an, ob die zugehörige Arbeitsmappenverbindung gelöscht wurde. wahr, wenn die Verbindung wurde gelöscht; andernfalls falsch.
Ist neu	True, wenn die Verbindung nicht zum ersten Mal aktualisiert wurde; andernfalls falsch. Diese Zustand kann auftreten, wenn der Benutzer die Datei speichert, bevor eine Abfrage die Rückgabe beendet hat.
Bleib am Leben	True, wenn das Tabellenkalkulationsprogramm Anstrengungen unternehmen soll, um die Verbindung aufrechtzuerhalten offen. Bei „false“ sollte die Anwendung die Verbindung nach dem Abrufen von schließen Information.
Name	Gibt den Namen der Verbindung an. Jede Verbindung muss einen eindeutigen Namen haben.
OdcDatei	Gibt den vollständigen Pfad zur externen Verbindungsdatei an, von der diese Verbindung stammt erstellt. Wenn eine Verbindung beim Versuch, Daten zu aktualisieren, fehlschlägt und reconnectionMethod=1, dann versucht die Tabellenkalkulationsanwendung erneut, Informationen aus der externen Verbindungsdatei zu verwenden anstelle des in die Arbeitsmappe eingebetteten Verbindungsobjekts.
OnlyUseConnectionFile	Gibt an, ob die Tabellenkalkulationsanwendung immer und nur die verwenden soll Verbindungsinformationen in der externen Verbindungsdatei, die durch das Attribut odcFile angegeben wird wenn die Verbindung aktualisiert wird. Wenn falsch, dann die Tabellenkalkulationsanwendung sollte dem durch das Attribut reconnectionMethod angegebenen Verfahren folgen
Parameter	Ruft ConnectionParameterCollection für eine ODBC- oder Webabfrage ab.
ReConnectionMethod	Geben Sie den ReconnectionMethod-Typ an
AktualisierenIntern	Gibt die Anzahl der Minuten zwischen automatischen Aktualisierungen der Verbindung an.
Beim Laden aktualisieren	True, wenn diese Verbindung beim Öffnen der Datei aktualisiert werden soll; andernfalls falsch.
Daten speichern	True, wenn die über die Verbindung abgerufenen externen Daten zum Füllen einer Tabelle gespeichert werden sollen mit dem Arbeitsbuch; andernfalls falsch.
Passwort speichern	True, wenn das Kennwort als Teil der Verbindungszeichenfolge gespeichert werden soll; andernfalls falsch.
Quelldatei	Wird verwendet, wenn die externe Datenquelle dateibasiert ist. Bei einer Verbindung zu solchen Daten source fehlschlägt, versucht die Tabellenkalkulationsanwendung, eine direkte Verbindung zu dieser Datei herzustellen. Vielleicht ausgedrückt in URI oder systemspezifischer Dateipfadnotation.
SSOID	Bezeichner für Single Sign On (SSO), der für die Authentifizierung zwischen einem Intermediate verwendet wird SpreadsheetML-Server und die externe Datenquelle.
Typ	Gibt den Datenquellentyp an.

Möglichkeit zum Formatieren einer Teilzeichenfolge des DataLabels-Textes

Aspose.Cells for .NET 8.4.1 hat die DataLabels.Characters-Methode verfügbar gemacht, um eine Instanz der FontSetting-Klasse abzurufen, die der Teilzeichenfolge von ChartPoints.DataLabels entspricht. Die Instanz der FontSetting-Klasse kann wiederum verwendet werden, um die Teilzeichenfolge der DataLabels mit unterschiedlichen Schriftarteinstellungen und Farben zu formatieren.

Der folgende Codeausschnitt zeigt, wie die DataLabels.Characters-Methode verwendet wird.

 //Create a workbook from source Excel file

Aspose.Cells.Workbook workbook = new Aspose.Cells.Workbook(input);

//Access first worksheet

Aspose.Cells.Worksheet worksheet = workbook.Worksheets[0];

//Access the first chart inside the sheet

Aspose.Cells.Charts.Chart chart = worksheet.Charts[0];

//Access the data label of first series first point

Aspose.Cells.Charts.DataLabels labels = chart.NSeries[0].Points[0].DataLabels;

//Set data label text

labels.Text = "Rich Text Label";

//Set the font setting of the first 10 characters

Aspose.Cells.FontSetting settings = labels.Characters(0, 10);

settings.Font.Color = System.Drawing.Color.Red;

settings.Font.IsBold = true;

//Save the workbook

workbook.Save(output);

Möglichkeit, die gewünschten Bildabmessungen für den Export von Tabellenkalkulationen und Diagrammen festzulegen

Aspose.Cells for .NET 8.4.1 hat die ImageOrPrintOptions.SetDesiredSize-Methode verfügbar gemacht, um die Abmessungen des resultierenden Bildes festzulegen, während Tabellenkalkulationen und Diagramme in Bilder exportiert werden. Die Methode ImageOrPrintOptions.SetDesiredSize akzeptiert zwei ganzzahlige Parameter, wobei der erste die gewünschte Breite und der zweite die gewünschte Höhe ist.

Das folgende Code-Snippet zeigt, wie Sie die gewünschten Abmessungen beim Exportieren des Arbeitsblatts auf PNG festlegen.

 //Create workbook object from source file

Aspose.Cells.Workbook workbook = new Aspose.Cells.Workbook(input);

//Access first worksheet

Aspose.Cells.Worksheet worksheet = workbook.Worksheets[0];

//Create an instance of ImageOrPrintOptions

Aspose.Cells.Rendering.ImageOrPrintOptions options = new Aspose.Cells.Rendering.ImageOrPrintOptions();

//Set resultant image format

options.ImageFormat = System.Drawing.Imaging.ImageFormat.Png;

//Set desired dimensions as 400x400

options.SetDesiredSize(400, 400);

//Render sheet to image

Aspose.Cells.Rendering.SheetRender renderer = new Aspose.Cells.Rendering.SheetRender(worksheet, options);

renderer.ToImage(0, "output.png");

Dieselbe Eigenschaft kann auch zum Konvertieren von Diagrammen in Bilder verwendet werden.

Rendern von Kommentaren zu PDF

Mit der Veröffentlichung von v8.4.1 hat Aspose.Cells API die PageSetup.PrintComments-Eigenschaft und die PrintCommentsType-Enumeration bereitgestellt, um das Rendern von Kommentaren beim Konvertieren von Tabellenkalkulationen in das PDF-Format zu erleichtern. Die PrintCommentsType-Enumeration hat die folgenden Konstanten.

PrintCommentsType.PrintNoComments: Kommentare sollen nicht gerendert werden.
PrintCommentsType.PrintInPlace: Kommentare sollen dort gerendert werden, wo sie platziert sind.
PrintCommentsType.PrintSheetEnd: Kommentare sollen am Ende des Arbeitsblatts gerendert werden.

Der folgende Beispielcode veranschaulicht die Verwendung der PageSetup.PrintComments-Eigenschaft zum Rendern der Kommentare unter Verwendung aller möglichen PrintCommentsType-Enumerationswerte.

 //Create an instance of workbook

Aspose.Cells.Workbook workbook = new Aspose.Cells.Workbook(input);

//Access first worksheet

Aspose.Cells.Worksheet worksheet = workbook.Worksheets[0];

//Print no comments

worksheet.PageSetup.PrintComments = Aspose.Cells.PrintCommentsType.PrintNoComments;

//Save workbook in PDF format without comments

workbook.Save("nocomments.pdf");

//Print the comments as displayed on sheet

worksheet.PageSetup.PrintComments = Aspose.Cells.PrintCommentsType.PrintInPlace;

//Save workbook in PDF format while rendering comments in place

workbook.Save("printinplace.pdf");

//Print the comments at the end of sheet

worksheet.PageSetup.PrintComments = Aspose.Cells.PrintCommentsType.PrintSheetEnd;

//Save workbook in PDF format while rendering comments at the end of worksheet

workbook.Save("printsheetend.pdf");

Verschieben Sie Arbeitsblätter in Aspose.Cells.GridDesktop

Aspose.Cells.GridDesktop stellt die WorksheetCollection.MoveTo-Methode bereit, die verwendet werden kann, um ein Arbeitsblatt in den angegebenen Index zu verschieben. Das vorgenannte Verfahren nimmt die Indizes (nullbasiert) des Quellarbeitsblatts und des Zielarbeitsblatts als Parameter.

Der folgende Beispielcode veranschaulicht die Verwendung der WorksheetCollection.MoveTo-Eigenschaft.

 //Move the second worksheet to 4th position.

GridDesktop1.Worksheets.MoveTo(1, 3);

Workbook.IsLicensed-Eigenschaft hinzugefügt

Aspose.Cells for .NET 8.4.1 hat Workbook.IsLicensed verfügbar gemacht, was bei der Bestimmung, ob die Lizenz erfolgreich geladen wurde oder nicht, eine große Hilfe sein könnte. Wenn Sie auf diese Eigenschaft zugreifen, bevor Sie die Lizenz festlegen, wird false zurückgegeben und umgekehrt, die Lizenz sollte jedoch gültig sein.

Der folgende Beispielcode veranschaulicht die Verwendung der Workbook.IsLicensed-Eigenschaft.

 //Create workbook object before setting a license

Aspose.Cells.Workbook workbook = new Aspose.Cells.Workbook();

//Check if the license is loaded or not

if (!workbook.IsLicensed)

{

    //Set license

    Aspose.Cells.License license = new Aspose.Cells.License();

    lic.SetLicense(licPath);

}

else

{

    //do process

}

ImageOrPrintOptions.SVGFitToViewPort-Eigenschaft hinzugefügt

Aspose.Cells for .NET 8.4.1 hat die SVGFitToViewPort-Eigenschaft für die ImageOrPrintOptions-Klasse verfügbar gemacht, die verwendet werden kann, um das viewBox-Attribut für das SVG-Dateiformat zu aktivieren, während Tabellenkalkulationen oder Diagramme in das SVG-Format exportiert werden. Der Standardwert dieser Eigenschaft ist „false“, daher wird das Basis-XML für die SVG-Datei, die ohne Festlegen der oben genannten Eigenschaft generiert wird, das viewBox-Attribut nicht enthalten.

Der folgende Beispielcode veranschaulicht die Verwendung der ImageOrPrintOptions.SVGFitToViewPort-Eigenschaft.

 //Create workbook object from source file

Aspose.Cells.Workbook workbook = new Aspose.Cells.Workbook(input);

//Access first worksheet

Aspose.Cells.Worksheet worksheet = workbook.Worksheets[0];

//Create an instance of ImageOrPrintOptions

Aspose.Cells.Rendering.ImageOrPrintOptions options = new Aspose.Cells.Rendering.ImageOrPrintOptions();

//Set image format to SVG

options.SaveFormat = Aspose.Cells.SaveFormat.SVG;

//Set the SVGFitToViewPort to true

options.SVGFitToViewPort = true;

//Create an instance of SheetRender and initialize it with worksheet instance as well as object of ImageOrPrintOptions

Aspose.Cells.Rendering.SheetRender renderer = new Aspose.Cells.Rendering.SheetRender(worksheet, options);

renderer.ToImage(0, "output.svg");

Veraltete APIs

Methode Workbook.ValidateFormula Veraltet

Verwenden Sie die Methode Cell.Formula, um die Formel zu validieren.

Öffentlich API Änderungen in Aspose.Cells 8.4.0 Öffentlich API Änderungen in Aspose.Cells 8.4.2