creare-charts-in-word-documenti-usando-csharp

Come sviluppatore C#, puoi inserire vari tipi di grafici nei documenti di Word a livello di codice. Aiuta a presentare graficamente i tuoi dati e le tue informazioni. In questo articolo imparerai come creare grafici nei documenti di Word usando C#.

I seguenti argomenti sono discussi/trattati in questo articolo:

API C# per inserire grafici nei documenti di Word

Per inserire i grafici nei file DOCX, utilizzeremo Aspose.Words for .NET API. Ti consente di generare, modificare, convertire, eseguire il rendering e stampare file senza utilizzare Microsoft Word direttamente all’interno di applicazioni multipiattaforma. L’API consente di inserire vari tipi di grafici supportati nei documenti di Word a livello di codice.

Puoi scaricare la DLL dell’API o installarla utilizzando NuGet.

Install-Package Aspose.Words

Crea grafici a colonne nei documenti di Word

Puoi creare grafici a colonne nei documenti di Word a livello di codice seguendo i passaggi indicati di seguito:

  • Innanzitutto, crea un nuovo documento utilizzando la classe Document.
  • Ora, crea un’istanza della classe DocumentBuilder con l’oggetto della classe Document.
  • Quindi, chiama il metodo DocumentBuilder.InsertChart(). Passa ChartType come Colonna, con altezza e larghezza come parametri di input.
  • Ottieni risultati nell’oggetto classe Shape.
  • Ora, crea un’istanza della classe Chart e assegna ad essa l’oggetto Shape.Chart. Fornisce l’accesso alle proprietà del grafico se questa forma ha un grafico.
  • Quindi, ottieni la raccolta di serie di grafici nell’oggetto ChartSeriesCollection.
  • Crea una matrice di nomi di categoria.
  • Ora, chiama il metodo ChartSeriesCollection.Add() per aggiungere serie di grafici. Passa il nome, l’array di categoria e i valori come parametri di input. Ripetere questo passaggio per aggiungere più serie.
  • Infine, chiama il metodo Document.Save() con il percorso del file di output per salvare il file.

Nell’esempio di codice seguente viene illustrato come creare un grafico a colonne in un documento di Word usando C#.

// Crea un documento
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Aggiungi grafico con dati predefiniti. È possibile specificare diversi tipi e dimensioni di grafici.
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);

// La proprietà del grafico di Shape contiene tutte le opzioni relative al grafico.
Chart chart = shape.Chart;

// Ottieni la raccolta di serie di grafici.
ChartSeriesCollection seriesColl = chart.Series;
// Controlla il conteggio delle serie.
Console.WriteLine(seriesColl.Count);

// Elimina le serie generate di default.
seriesColl.Clear();

// Crea un array di nomi di categoria, in questo esempio abbiamo due categorie.
string[] categories = new string[] { "AW Category 1", "AW Category 2" };

// Aggiunta di nuove serie. Si noti che gli array di dati non devono essere vuoti e gli array devono avere le stesse dimensioni.
seriesColl.Add("AW Series 1", categories, new double[] { 1, 2 });
seriesColl.Add("AW Series 2", categories, new double[] { 3, 4 });
seriesColl.Add("AW Series 3", categories, new double[] { 5, 6 });
seriesColl.Add("AW Series 4", categories, new double[] { 7, 8 });
seriesColl.Add("AW Series 5", categories, new double[] { 9, 10 });

// Salva il documento
doc.Save(@"C:\Files\Words\ColumnsChart.docx");
Crea istogrammi in documenti di Word usando C#.

Crea grafici a colonne nei documenti di Word usando C#

Crea grafici a dispersione nei documenti di Word usando C#

Puoi inserire grafici a dispersione nei tuoi documenti di Word a livello di codice seguendo i passaggi menzionati in precedenza. Tuttavia, è necessario impostare ChartType.Scatter nel metodo DocumentBuilder.InsertChart().

Nell’esempio di codice seguente viene illustrato come creare un grafico a dispersione in un documento di Word usando C#.

// Crea un nuovo documento
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Inserisci grafico a dispersione.
Shape shape = builder.InsertChart(ChartType.Scatter, 432, 252);
Chart chart = shape.Chart;

// Utilizzare questo sovraccarico per aggiungere serie a qualsiasi tipo di grafici a dispersione.
chart.Series.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });

// Salva il documento
doc.Save(@"C:\Files\Words\ScatterChart.docx");
Crea grafici a dispersione nei documenti di Word usando C#.

Crea grafici a dispersione nei documenti di Word usando C#

Inserisci i grafici ad area nei documenti di Word usando C#

È possibile inserire grafici ad area nei documenti di Word a livello di codice seguendo i passaggi indicati in precedenza. Tuttavia, è necessario impostare ChartType.Area nel metodo DocumentBuilder.InsertChart().

Nell’esempio di codice seguente viene illustrato come creare un grafico ad area in un documento di Word usando C#.

// Crea un nuovo documento
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Inserisci grafico ad area.
Shape shape = builder.InsertChart(ChartType.Area, 432, 252);
Chart chart = shape.Chart;

// Usa questo sovraccarico per aggiungere serie a qualsiasi tipo di grafico Area, Radar e Stock.
chart.Series.Add("AW Series 1", new DateTime[] {
    new DateTime(2002, 05, 01),
    new DateTime(2002, 06, 01),
    new DateTime(2002, 07, 01),
    new DateTime(2002, 08, 01),
    new DateTime(2002, 09, 01)},
    new double[] { 32, 32, 28, 12, 15 });

// Salva il documento
doc.Save(@"C:\Files\Words\AreaChart.docx");
Inserisci i grafici ad area nei documenti di Word usando C#.

Inserisci i grafici ad area nei documenti di Word usando C#

Inserisci grafici a bolle nei documenti di Word usando C#

Puoi inserire grafici a bolle nei documenti di Word a livello di codice seguendo i passaggi indicati in precedenza. Tuttavia, è necessario impostare ChartType.Bubble nel metodo DocumentBuilder.InsertChart().

Nell’esempio di codice seguente viene illustrato come creare un grafico a bolle in un documento di Word usando C#.

// Crea un nuovo documento
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Inserisci grafico a bolle.
Shape shape = builder.InsertChart(ChartType.Bubble, 432, 252);
Chart chart = shape.Chart;

// Usa questo sovraccarico per aggiungere serie a qualsiasi tipo di grafici a bolle.
chart.Series.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 }, new double[] { 10, 4, 8 });

// Salva il documento
doc.Save(@"C:\Files\Words\BubbleChart.docx");
Inserisci grafici a bolle nei documenti di Word usando C#.

Inserisci grafici a bolle nei documenti di Word usando C#

Ottieni una licenza gratuita

Puoi provare l’API senza limitazioni di valutazione richiedendo una licenza temporanea gratuita.

Conclusione

In questo articolo hai imparato come creare grafici nei documenti di Word usando C#. In particolare, hai imparato a creare a livello di codice grafici a colonne, ad area, a bolle e a dispersione nei documenti di Word. Allo stesso modo, puoi creare altri tipi di grafici. Puoi saperne di più su Aspose.Words per .NET API usando la documentazione. In caso di ambiguità, non esitare a contattarci sul forum.

Guarda anche