Como Criar Gráficos em Planilha Excel com C# e IronXL

Por Que Devo Usar o Gerenciador de Pacotes NuGet?

Você também pode inserir o seguinte comando no Prompt de Comando do Desenvolvedor:

Install-Package IronXL.Excel

Quais são os métodos alternativos de instalação?

Or download from here: https://ironsoftware.com/csharp/excel/packages/IronXL.zip

Uma vez instalado, o IronXL permite que você crie novos arquivos Excel do zero ou trabalhe com planilhas existentes, adequado tanto para novos projetos quanto para integração em sistemas legados.

Tutorial de Como Fazer

Quais Namespaces São Necessários para Gráficos do Excel?

Adicione os namespaces necessários para trabalhar com gráficos do Excel no IronXL:

using IronXL;
using IronXL.Drawing.Charts;

using IronXL;
using IronXL.Drawing.Charts;

Imports IronXL
Imports IronXL.Drawing.Charts

Estes namespaces fornecem acesso a todas as funcionalidades relacionadas a gráficos. O namespace IronXL contém operações principais de livro de trabalho e planilha, enquanto IronXL.Drawing.Charts lida com criação de gráficos e recursos de personalização.

Como Adiciono Múltiplas Séries de Dados ao Meu Gráfico?

Adicione o código para criar o gráfico do Excel programaticamente com o IronXL:

:path=/static-assets/excel/content-code-examples/how-to/csharp-create-excel-chart-programmatically-example.cs

using IronXL;
using IronXL.Drawing.Charts;

// Load the existing Excel workbook
WorkBook wb = WorkBook.Load("Chart_Ex.xlsx");
// Use the default worksheet from the workbook
WorkSheet ws = wb.DefaultWorkSheet;

// Create a column chart at the specified range of cells
var chart = ws.CreateChart(ChartType.Column, 10, 15, 25, 20);

// Define the range for the x-axis data
const string xAxis = "A2:A7";

// Add a series for the chart using data in the range and give it a title from the first row
var series = chart.AddSeries(xAxis, "B2:B7");
series.Title = ws["B1"].StringValue;

// Add another series
series = chart.AddSeries(xAxis, "C2:C7");
series.Title = ws["C1"].StringValue;

// Add a third series
series = chart.AddSeries(xAxis, "D2:D7");
series.Title = ws["D1"].StringValue;

// Set the chart title
chart.SetTitle("Column Chart");
// Position the legend at the bottom of the chart
chart.SetLegendPosition(LegendPosition.Bottom);
// Plot the chart with the provided data
chart.Plot();
// Save the workbook with the newly added chart
wb.SaveAs("Exported_Column_Chart.xlsx");

Imports IronXL
Imports IronXL.Drawing.Charts

' Load the existing Excel workbook
Dim wb As WorkBook = WorkBook.Load("Chart_Ex.xlsx")
' Use the default worksheet from the workbook
Dim ws As WorkSheet = wb.DefaultWorkSheet

' Create a column chart at the specified range of cells
Dim chart = ws.CreateChart(ChartType.Column, 10, 15, 25, 20)

' Define the range for the x-axis data
Const xAxis As String = "A2:A7"

' Add a series for the chart using data in the range and give it a title from the first row
Dim series = chart.AddSeries(xAxis, "B2:B7")
series.Title = ws("B1").StringValue

' Add another series
series = chart.AddSeries(xAxis, "C2:C7")
series.Title = ws("C1").StringValue

' Add a third series
series = chart.AddSeries(xAxis, "D2:D7")
series.Title = ws("D1").StringValue

' Set the chart title
chart.SetTitle("Column Chart")
' Position the legend at the bottom of the chart
chart.SetLegendPosition(LegendPosition.Bottom)
' Plot the chart with the provided data
chart.Plot()
' Save the workbook with the newly added chart
wb.SaveAs("Exported_Column_Chart.xlsx")

O método CreateChart recebe parâmetros para tipo de gráfico e posição (coluna à esquerda, linha superior, coluna à direita, linha inferior). Esta posição utiliza coordenadas de células para posicionar precisamente seu gráfico dentro da planilha. Você pode criar múltiplos gráficos em uma única folha de trabalho ou distribuí-los por diferentes folhas.

Ao trabalhar com séries de dados, o IronXL permite que você referencie intervalos de células utilizando a notação padrão do Excel. Isso torna intuitivo para desenvolvedores familiarizados com o Excel transitar para a criação programática de gráficos. Além disso, você pode combinar gráficos com fórmulas do Excel para criar visualizações dinâmicas que se atualizam automaticamente quando os dados mudam.

Como Posso Criar Diferentes Tipos de Gráficos?

O IronXL suporta vários tipos de gráficos além de gráficos de colunas. Aqui está um exemplo de criação de um gráfico de linha com estilo personalizado:

// Create a line chart for trend analysis
var lineChart = ws.CreateChart(ChartType.Line, 10, 22, 25, 32);

// Add data series with smooth lines
var trendSeries = lineChart.AddSeries("A2:A7", "B2:B7");
trendSeries.Title = "Q1 Sales Trend";

// Customize chart appearance
lineChart.SetTitle("Quarterly Sales Trend Analysis");
lineChart.SetLegendPosition(LegendPosition.Right);

// You can also create combination charts
var comboChart = ws.CreateChart(ChartType.ColumnClustered, 27, 15, 42, 25);
comboChart.AddSeries("A2:A7", "B2:B7"); // Column series
comboChart.AddSeries("A2:A7", "C2:C7"); // Can be styled as line

comboChart.Plot();

// Create a line chart for trend analysis
var lineChart = ws.CreateChart(ChartType.Line, 10, 22, 25, 32);

// Add data series with smooth lines
var trendSeries = lineChart.AddSeries("A2:A7", "B2:B7");
trendSeries.Title = "Q1 Sales Trend";

// Customize chart appearance
lineChart.SetTitle("Quarterly Sales Trend Analysis");
lineChart.SetLegendPosition(LegendPosition.Right);

// You can also create combination charts
var comboChart = ws.CreateChart(ChartType.ColumnClustered, 27, 15, 42, 25);
comboChart.AddSeries("A2:A7", "B2:B7"); // Column series
comboChart.AddSeries("A2:A7", "C2:C7"); // Can be styled as line

comboChart.Plot();

' Create a line chart for trend analysis
Dim lineChart = ws.CreateChart(ChartType.Line, 10, 22, 25, 32)

' Add data series with smooth lines
Dim trendSeries = lineChart.AddSeries("A2:A7", "B2:B7")
trendSeries.Title = "Q1 Sales Trend"

' Customize chart appearance
lineChart.SetTitle("Quarterly Sales Trend Analysis")
lineChart.SetLegendPosition(LegendPosition.Right)

' You can also create combination charts
Dim comboChart = ws.CreateChart(ChartType.ColumnClustered, 27, 15, 42, 25)
comboChart.AddSeries("A2:A7", "B2:B7") ' Column series
comboChart.AddSeries("A2:A7", "C2:C7") ' Can be styled as line

comboChart.Plot()

Como é a Saída Final do Gráfico?

Um objeto Workbook e um objeto Worksheet são criados. O método CreateChart do objeto Worksheet é chamado para especificar o tipo de gráfico e a localização do gráfico. As séries do gráfico são adicionadas com título e legenda.

**Figura 2** – *Saída do gráfico*

O gráfico resultante fornece uma representação visual clara dos seus dados. O IronXL lida com toda a formatação complexa XML do Excel nos bastidores, permitindo que você se concentre em sua lógica de negócios. Para mais exemplos de criação de gráficos, verifique nossa página de exemplos de gráficos do Excel.

Personalização Avançada de Gráficos

Além da criação básica de gráficos, o IronXL oferece opções extensas de personalização. Você pode modificar cores, adicionar rótulos de dados, ajustar escalas de eixos e aplicar várias opções de formatação. Os Recursos de Salvar & Exportar da biblioteca garantem que seus gráficos sejam preservados corretamente em diferentes formatos e versões do Excel.

Ao trabalhar com grandes conjuntos de dados, considere implementar paginação ou filtragem de dados antes da criação de gráficos. Essa abordagem garante desempenho ideal e previne visualizações poluídas. O gerenciamento eficiente de memória do IronXL permite que você trabalhe com arquivos Excel substanciais sem degradação de desempenho.

Acesso rápido à biblioteca

### Documentação de Referência da API IronXL

Learn more and share how to merge, unmerge, and work with cells in Excel spreadsheets using the handy [Documentação de Referência da API IronXL](https://ironsoftware.com/csharp/excel/object-reference/api/).

Documentação de Referência da API IronXL