Modifiche all API pubblica in Aspose.Cells 8.3.1

Questo documento descrive le modifiche all’API Aspose.Cells dalla versione 8.3.0 a 8.3.1 che potrebbero interessare a sviluppatori di moduli/applicazioni.

API aggiunte

Proprietà ShowCellRange di DataLabels aggiunta

La proprietà ShowCellRange è stata aggiunta alla classe DataLabels per emulare la funzionalità di formattazione dei Data Labels del grafico in tempo reale. Si prega di notare che Excel fornisce questa funzione attraverso i seguenti passaggi:

Seleziona le Etichette dati della serie e fai clic con il pulsante destro per aprire il menu a comparsa.
Fare clic su Formato etichette dati… e verrà visualizzato Opzioni etichetta.
Selezionare o deselezionare la casella di controllo L’etichetta contiene - Valore delle celle.

Il codice di esempio di seguito accede alle Etichette dati della Serie del grafico e imposta poi il metodo DataLabels.ShowCellRange su true per imitare la funzione di Excel L’etichetta contiene - Valori delle celle.

 //Create workbook from the source Excel file

Workbook workbook = new Workbook("sample.xlsx");

//Access the first worksheet

Worksheet worksheet = workbook.Worksheets[0];

//Access the chart inside the worksheet

Chart chart = worksheet.Charts[0];

//Check the "Label Contains - Value From Cells"

DataLabels dataLabels = chart.NSeries[0].DataLabels;

dataLabels.ShowCellRange = true;

//Save the workbook

workbook.Save("output.xlsx");

VB.NET

'Create workbook from the source Excel file

Dim m_workbook As Workbook = New Workbook("sample.xlsx")

'Access the first worksheet

Dim m_worksheet As Worksheet = m_workbook.Worksheets(0)

'Access the chart inside the worksheet

Dim m_chart As Chart = m_worksheet.Charts(0)

'Check the "Label Contains - Value From Cells"

Dim m_dataLabels As DataLabels = m_chart.NSeries(0).DataLabels

m_dataLabels.ShowCellRange = True

'Save the workbook

m_workbook.Save("output.xlsx")

Si prega di consultare l’articolo Mostra l’intervallo di celle come etichette dati per ulteriori informazioni.

Aggiunti i metodi Cell.GetTable & ListObject.PutCellValue

I metodi Cell.GetTable & ListObject.PutCellValue sono stati aggiunti con Aspose.Cells for .NET 8.3.1 al fine di agevolare gli utenti nell’accesso al ListObject da una cella e nell’aggiunta di valori al suo interno utilizzando gli offset di riga e colonna. Il seguente codice di esempio carica il foglio di calcolo di origine e aggiunge valori all’interno della tabella.

 //Create workbook from source Excel file

Workbook workbook = new Workbook("source.xlsx");

//Access first worksheet

Worksheet worksheet = workbook.Worksheets[0];

//Access cell D5 which lies inside the table

Cell cell = worksheet.Cells["D5"];

//Put value inside the cell D5

cell.PutValue("D5 Data");

//Access the Table from this cell

ListObject table = cell.GetTable();

//Add some value using Row and Column Offset

table.PutCellValue(2, 2, "Offset [2,2]");

//Save the workbook

workbook.Save("output.xlsx");

VB.NET

 'Create workbook from source Excel file

Dim m_workbook As Workbook = New Workbook("source.xlsx")

'Access first worksheet

Dim m_worksheet As Worksheet = m_workbook.Worksheets(0)

'Access cell D5 which lies inside the table

Dim m_cell As Cell = m_worksheet.Cells("D5")

'Put value inside the cell D5

m_cell.PutValue("D5 Data")

'Access the Table from this cell

Dim table As ListObject = m_cell.GetTable()

'Add some value using Row and Column Offset

table.PutCellValue(2, 2, "Offset [2,2]")

'Save the workbook

m_workbook.Save("output.xlsx")

Si prega di consultare l’articolo Accesso alla tabella da una cella e aggiunta dei valori al suo interno utilizzando gli offset di riga e colonna per ulteriori informazioni.

Aggiunta la proprietà OdsSaveOptions.IsStrictSchema11

La proprietà IsStrictSchema11 è stata aggiunta alla classe OdsSaveOptions per consentire agli sviluppatori di salvare il foglio di calcolo nel formato conforme alla specifica ODF v1.2. Il valore predefinito della proprietà IsStrictSchema11 è false, ciò significa che a partire dalla versione 8.3.1 delle API di Aspose.Cells i file ODS verranno salvati per impostazione predefinita come formato ODF versione 1.2.

Il frammento di codice fornito di seguito salva il file ODS nel formato ODF 1.2.

 //Create workbook

Workbook workbook = new Workbook();

//Access first worksheet

Worksheet worksheet = workbook.Worksheets[0];

//Put some value in cell A1

Cell cell = worksheet.Cells["A1"];

cell.PutValue("Welcome to Aspose!");

//Save ODS in ODF 1.2 version which is default

OdsSaveOptions options = new OdsSaveOptions();

workbook.Save("ODF1.2.ods", options);

//Save ODS in ODF 1.1 version

options.IsStrictSchema11 = true;

workbook.Save("ODF1.1.ods", options);

VB.NET

 'Create workbook 

Dim m_workbook As Workbook = New Workbook()

'Access first worksheet

Dim m_worksheet As Worksheet = m_workbook.Worksheets(0)

'Put some value in cell A1

Dim m_cell As Cell = m_worksheet.Cells("A1")

m_cell.PutValue("Welcome to Aspose!")

'Save ODS in ODF 1.2 version which is default

Dim options As OdsSaveOptions = New OdsSaveOptions()

m_workbook.Save("ODF1.2.ods", options)

'Save ODS in ODF 1.1 version

options.IsStrictSchema11 = True

m_workbook.Save("ODF1.1.ods", options)

Si prega di consultare l’articolo Salva il file ODS nelle specifiche ODF 1.1 e 1.2 per ulteriori informazioni.

Aggiunto il metodo SparklineCollection.Add

Le API di Aspose.Cells hanno esposto il metodo SparklineCollection.Add(string dataRange, int row, int column) per specificare l’Intervallo dati e la Posizione del Gruppo Sparkline. Si noti che Excel fornisce la stessa funzionalità attraverso i seguenti passaggi.

Selezionare la cella contenente la tua Linea di tendenza.
Selezionare Modifica dati dalla linea di tendenza nella sezione Progettazione.
Scegliere Modifica posizione del gruppo e dati.
Specificare Intervallo dati e Posizione.

Il seguente codice di esempio carica il foglio di calcolo sorgente, accede al primo gruppo di Linee di tendenza e aggiunge nuovi intervalli e posizioni dati per il gruppo di Linee di tendenza.

 //Create workbook from source Excel file

Workbook workbook = new Workbook("source.xlsx");

//Access first worksheet

Worksheet worksheet = workbook.Worksheets[0];

//Access the first sparkline group

SparklineGroup group = worksheet.SparklineGroupCollection[0];

//Add Data Ranges and Locations inside this sparkline group

group.SparklineCollection.Add("D5:O5", 4, 15);

group.SparklineCollection.Add("D6:O6", 5, 15);

group.SparklineCollection.Add("D7:O7", 6, 15);

group.SparklineCollection.Add("D8:O8", 7, 15);

//Save the workbook

workbook.Save("output.xlsx");

VB.NET

 'Create workbook from source Excel file

Dim m_workbook As Workbook = New Workbook("source.xlsx")

'Access first worksheet

Dim m_worksheet As Worksheet = m_workbook.Worksheets(0)

'Access the first sparkline group

Dim group As SparklineGroup = m_worksheet.SparklineGroupCollection(0)

'Add Data Ranges and Locations inside this sparkline group

group.SparklineCollection.Add("D5:O5", 4, 15)

group.SparklineCollection.Add("D6:O6", 5, 15)

group.SparklineCollection.Add("D7:O7", 6, 15)

group.SparklineCollection.Add("D8:O8", 7, 15)

'Save the workbook

m_workbook.Save("output.xlsx")

Si prega di consultare l’articolo Copia Linea di tendenza specificando l’Intervallo dati e la Posizione del Gruppo Sparkline per ulteriori informazioni.

Modifiche dell API pubblica in Aspose.Cells 8.3.0 Modifiche alle API pubbliche in Aspose.Cells 8.3.2