1. IronXL
  2. Tutoriais
  3. Criar e editar gráficos
Como criar e editar gráficos do Excel em C#

How to Create and Edit Excel Charts in C#

Curtis Chau
Curtis Chau
Atualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronXL permite que desenvolvedores C# criem, editem e removam gráficos Excel programaticamente usando chamadas de API simples. Você pode gerar tipos de gráficos de coluna, linha, pizza e outros diretamente de seus dados sem dependências do Excel Interop.

No Excel, um gráfico é uma representação gráfica de dados utilizada para exibir e analisar informações visualmente. O Excel fornece vários tipos de gráficos, como gráficos de barras, gráficos de linha e gráficos de pizza, cada um adequado para diferentes dados e necessidades de análise. When working with IronXL's comprehensive Excel library, you can programmatically create these visualizations to enhance your reports and dashboards.

Início rápido: Crie e Trace um Gráfico de Linha em Segundos

Com o IronXL, você pode instalar, carregar uma planilha, chamar CreateChart, adicionar sua série de dados, definir seu título e posição da legenda, e Plot—tudo em apenas algumas linhas. Este exemplo mostra como criar um gráfico usando métodos nativos do C# sem a sobrecarga do Interop.

  1. Instale IronXL com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronXl.Excel

  2. Copie e execute este trecho de código.

    // Load workbook and create a line chart with data series
var chart = workSheet.CreateChart(ChartType.Line, 2, 2, 15, 10).AddSeries("A2:A10","B2:B10").Title = workSheet["B1"].StringValue; 
// Set title and legend position, then plot the chart
chart.SetTitle("Quick Line Chart").SetLegendPosition(LegendPosition.Bottom).Plot();

  3. Implante para testar em seu ambiente de produção.

    Comece a usar IronXL em seu projeto hoje com uma avaliação gratuita

    arrow pointer
### Fluxo de trabalho mínimo (5 etapas)
  1. Baixe a biblioteca C# para criar e editar gráficos
  2. Prepare os dados para a criação do gráfico.
  3. Use o método `CreateChart` para definir o tipo e a posição do gráfico
  4. Use o método `AddSeries` para adicionar séries de dados
  5. Trace o gráfico usando o método `Plot`


Comece a usar o IronXL

Como Faço para Criar Gráficos no Excel?

O IronXL suporta gráficos de coluna, dispersão, linha, pizza, barra e área. Para criar um gráfico, especifique os seguintes componentes. This flexibility allows you to create Excel spreadsheets with rich visualizations tailored to your data presentation needs.

  1. Use CreateChart para especificar o tipo de gráfico e a localização da planilha.
  2. Adicione séries com AddSeries. Este método aceita uma única coluna para alguns tipos de gráficos. O primeiro parâmetro são os valores do eixo horizontal. O segundo são os valores do eixo vertical.
  3. Opcionalmente, especifique o nome da série, o nome do gráfico e a posição da legenda.
  4. Chame Plot para renderizar o gráfico. Chamadas múltiplas criam vários gráficos.

Let's create charts from the data in the chart.xlsx Excel file. A preview of the data is displayed below:

Planilha com dados de exemplo mostrando contagens mensais de animais para girafas, elefantes e rinocerontes de Jan-Jun

Qual é o Processo para Criar Gráficos de Coluna?

Gráficos de coluna são ideais para comparar valores entre categorias. When you load spreadsheet data, you can visualize it effectively using column charts to highlight differences between data points. O exemplo a seguir demonstra como criar um gráfico de coluna multisséries com dados de população animal:

:path=/static-assets/excel/content-code-examples/how-to/create-edit-charts-column-chart.cs
using IronXL;
using IronXL.Drawing.Charts;

WorkBook workBook = WorkBook.Load("chart.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Set the chart type and position
IChart chart = workSheet.CreateChart(ChartType.Column, 5, 5, 20, 10);

string xAxis = "A2:A7";

// Add the series
IChartSeries series = chart.AddSeries(xAxis, "B2:B7");
series.Title = workSheet["B1"].StringValue;

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

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

// Set the chart title
chart.SetTitle("Column Chart");

// Set the legend position
chart.SetLegendPosition(LegendPosition.Bottom);

// Plot the chart
chart.Plot();

workBook.SaveAs("columnChart.xlsx");
$vbLabelText   $csharpLabel
Planilha do Excel mostrando tabela de dados de animais e gráfico de coluna agrupado correspondente com contagens mensais de girafas, elefantes e rinocerontes

Como Faço para Criar Gráficos de Linha?

Gráficos de linha são excelentes para mostrar tendências ao longo do tempo. Como gráficos de linha exibem as mesmas informações que gráficos de coluna, alternar entre eles exige apenas mudar o tipo de gráfico. Isso torna os gráficos de linha particularmente úteis ao ler arquivos XLSX contendo dados de séries temporais:

:path=/static-assets/excel/content-code-examples/how-to/create-edit-charts-pie-chart.cs
using IronXL;
using IronXL.Drawing.Charts;

WorkBook workBook = WorkBook.Load("chart.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Set the chart type and position
IChart chart = workSheet.CreateChart(ChartType.Pie, 5, 5, 20, 10);

string xAxis = "A2:A7";

// Add the series
IChartSeries series = chart.AddSeries(xAxis, "B2:B7");
series.Title = workSheet["B1"].StringValue;

// Set the chart title
chart.SetTitle("Pie Chart");

// Set the legend position
chart.SetLegendPosition(LegendPosition.Bottom);

// Plot the chart
chart.Plot();

workBook.SaveAs("pieChart.xlsx");
$vbLabelText   $csharpLabel
Planilha do Excel mostrando tabela de dados de animais e gráfico de linha correspondente com três linhas de tendência para girafas, elefantes e rinocerontes

Quando Devo Usar Gráficos de Pizza?

Gráficos de pizza mostram proporções e porcentagens de um todo. Para gráficos de pizza, apenas uma coluna de dados é necessária, tornando-os mais simples de implementar. They're effective when you want to convert spreadsheet data into visual representations of market share, budget allocation, or category distribution:

:path=/static-assets/excel/content-code-examples/how-to/create-edit-charts-pie-chart.cs
using IronXL;
using IronXL.Drawing.Charts;

WorkBook workBook = WorkBook.Load("chart.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Set the chart type and position
IChart chart = workSheet.CreateChart(ChartType.Pie, 5, 5, 20, 10);

string xAxis = "A2:A7";

// Add the series
IChartSeries series = chart.AddSeries(xAxis, "B2:B7");
series.Title = workSheet["B1"].StringValue;

// Set the chart title
chart.SetTitle("Pie Chart");

// Set the legend position
chart.SetLegendPosition(LegendPosition.Bottom);

// Plot the chart
chart.Plot();

workBook.SaveAs("pieChart.xlsx");
$vbLabelText   $csharpLabel
Planilha com dados de vida selvagem e gráfico de pizza mostrando distribuição mensal de girafas, abril destacado com 89 girafas (21%)

Como Faço para Editar Gráficos Existentes?

Ao trabalhar com arquivos Excel existentes, pode ser necessário modificar gráficos já criados. O IronXL fornece métodos diretos para editar gráficos existentes, permitindo que você atualize títulos, reposicione legendas e atualize dados. This is useful when editing Excel files that contain pre-existing visualizations.

Você pode editar a posição da legenda e o título do gráfico em gráficos existentes. Para editar um gráfico, primeiro recupere-o acessando a propriedade Charts e selecionando o gráfico desejado. Em seguida, acesse as propriedades do gráfico para fazer suas edições:

:path=/static-assets/excel/content-code-examples/how-to/create-edit-charts-edit-chart.cs
using IronXL;
using IronXL.Drawing.Charts;

WorkBook workBook = WorkBook.Load("pieChart.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Retrieve the chart
IChart chart = workSheet.Charts[0];

// Edit the legend position
chart.SetLegendPosition(LegendPosition.Top);

// Edit the chart title
chart.SetTitle("Edited Chart");

workBook.SaveAs("editedChart.xlsx");
$vbLabelText   $csharpLabel
Pie chart showing monthly data from Jan-Jun with color-coded segments and legend below

Antes

Pie chart showing monthly data distribution from January to June with color-coded segments and legend

Depois

Como Faço para Remover Gráficos do Excel?

Às vezes, é preciso limpar arquivos Excel removendo gráficos desatualizados ou desnecessários. This is common when managing worksheets containing multiple visualizations. Para remover um gráfico existente de uma planilha, primeiro recupere o gráfico da propriedade Charts. Você receberá uma lista de gráficos. Passe o objeto gráfico alvo para RemoveChart:

:path=/static-assets/excel/content-code-examples/how-to/create-edit-charts-remove-chart.cs
using IronXL;
using IronXL.Drawing.Charts;
using System.Collections.Generic;

WorkBook workBook = WorkBook.Load("pieChart.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Retrieve the chart
List<IChart> chart = workSheet.Charts;

// Remove the chart
workSheet.RemoveChart(chart[0]);

workBook.SaveAs("removedChart.xlsx");
$vbLabelText   $csharpLabel

Personalização Avançada de Gráficos

Além da criação básica de gráficos, o IronXL suporta opções de personalização avançada. When creating complex reports or dashboards, you can combine charts with other Excel features like conditional formatting to create comprehensive data visualizations.

Para aplicativos de negócios, os gráficos frequentemente precisam de geração dinâmica a partir de consultas de banco de dados ou fontes de dados em tempo real. IronXL se integra perfeitamente com estruturas de dados .NET, permitindo que você crie gráficos a partir de DataTables, Lists, ou qualquer coleção enumerável. Isso o torna ideal para gerar relatórios automatizados que incluem elementos visuais.

Resumo

IronXL oferece uma solução completa para trabalhar com gráficos do Excel em aplicativos C#. Seja criando novas visualizações, modificando as existentes ou removendo gráficos desatualizados, a biblioteca oferece métodos intuitivos que não exigem Excel Interop. Combinando a funcionalidade de gráficos com outros recursos do IronXL, como manipulação e formatação de dados, você pode construir soluções sofisticadas de automação no Excel que aprimoram a apresentação e análise de dados em seus aplicativos .NET.

Perguntas frequentes

Como posso criar gráficos do Excel programaticamente em C# sem usar Interop?

IronXL fornece uma API simples para criar gráficos do Excel em C# sem dependências de interoperabilidade. Você pode usar o método CreateChart para especificar o tipo e a posição do gráfico, AddSeries para adicionar dados e Plot para renderizar o gráfico — tudo por meio de código C# nativo.

Que tipos de gráficos posso criar em planilhas do Excel usando C#?

O IronXL permite a criação de diversos tipos de gráficos, incluindo gráficos de colunas, dispersão, linhas, pizza, barras e área. Você pode especificar o tipo de gráfico ao chamar o método CreateChart e personalizar cada gráfico com títulos, legendas e séries de dados.

Como faço para adicionar séries de dados a um gráfico do Excel programaticamente?

Use o método AddSeries do IronXL para adicionar dados aos seus gráficos. Este método aceita intervalos de células como parâmetros — o primeiro parâmetro para os valores do eixo horizontal e o segundo para os valores do eixo vertical. Você pode adicionar várias séries para criar gráficos com múltiplas séries.

Qual é a maneira mais rápida de criar um gráfico de linhas no Excel usando C#?

Com o IronXL, você pode criar um gráfico de linhas em apenas algumas linhas de código: use CreateChart(ChartType.Line) para inicializar o gráfico, AddSeries() para adicionar seus intervalos de dados, SetTitle() para o título do gráfico e Plot() para renderizá-lo na planilha.

Posso personalizar propriedades do gráfico, como título e posição da legenda?

Sim, o IronXL permite a personalização completa de gráficos do Excel. Você pode usar SetTitle() para adicionar títulos aos gráficos, SetLegendPosition() para posicionar a legenda (superior, inferior, esquerda, direita) e, opcionalmente, especificar nomes de séries para melhor identificação dos dados.

Preciso ter o Microsoft Excel instalado para criar gráficos programaticamente?

Não, o IronXL funciona de forma independente, sem necessidade de instalar o Microsoft Excel. Ele lida internamente com todas as operações de arquivos do Excel e a criação de gráficos, sendo ideal para ambientes de servidor e aplicações onde o Excel não pode ser instalado.

Curtis Chau
Curtis Chau
  Converse agora mesmo com a equipe de engenharia.
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Leia mais

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/ready_to_started_202509.php
Line: 12
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 489
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/ready_to_started_202509.php
Line: 19
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 489
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

Pronto para começar?
Nuget Downloads 1,890,100 | Versão: 2026.3 acaba de ser lançado

Nesta página

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/still_scrolling_202512.php
Line: 17
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 71
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/still_scrolling_202512.php
Line: 24
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 71
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronXl.Excel
executar um exemplo Veja seus dados se transformarem em uma planilha.