Criar gráfico de pizza

Introdução

Criar gráficos é essencial para representar dados visualmente, e gráficos de pizza são uma das maneiras mais populares de ilustrar como as partes compõem um todo. Com o Aspose.Cells para .NET, você pode automatizar facilmente a geração de gráficos de pizza em arquivos do Excel. Neste tutorial, vamos nos aprofundar em como criar um gráfico de pizza do zero usando o Aspose.Cells para .NET, com um guia passo a passo para tornar o processo suave e direto. Não importa se você é novo na ferramenta ou está procurando aprimorar suas habilidades de automação do Excel, este guia tem tudo o que você precisa!

Pré-requisitos

Antes de mergulhar no código, certifique-se de ter o seguinte configurado:

Biblioteca Aspose.Cells para .NET: Certifique-se de ter o Aspose.Cells instalado em seu projeto. Se você ainda não o instalou, você pode baixá-lo emaqui.
Ambiente de desenvolvimento .NET: certifique-se de que seu projeto esteja configurado para usar o .NET Framework ou o .NET Core.
Conhecimento básico de C#: você deve estar familiarizado com programação em C#, especialmente programação orientada a objetos (POO).

Para usuários avançados, uma licença temporária pode ser aplicada para desbloquear todos os recursos do Aspose.Cells. Você pode solicitar uma deaqui.

Pacotes de importação

Para começar, importe os namespaces e pacotes necessários para este tutorial. Eles incluem operações básicas de E/S e o pacote Aspose.Cells.

using System;
using System.IO;

using Aspose.Cells;
using Aspose.Cells.Drawing;
using System.Drawing;
using Aspose.Cells.Charts;

Etapa 1: Crie uma nova pasta de trabalho

Primeiro, precisamos criar uma instância doWorkbook class, que representa o arquivo Excel. Uma pasta de trabalho contém várias planilhas e, para nosso exemplo, trabalharemos com duas planilhas — uma para dados e uma para o gráfico de pizza.

Workbook workbook = new Workbook();

Isso inicializa uma nova pasta de trabalho do Excel. Mas para onde vão os dados? Vamos cuidar disso na próxima etapa.

Etapa 2: Adicionar dados à planilha

Depois que a pasta de trabalho for criada, precisamos acessar a primeira planilha e dar um nome a ela. É aqui que inseriremos os dados necessários para o gráfico de pizza.

Worksheet sheet = workbook.Worksheets[0];
sheet.Name = "Data";
Cells cells = sheet.Cells;

Agora, podemos inserir alguns dados fictícios de vendas representando diferentes regiões:

cells["A1"].PutValue("Region");
cells["A2"].PutValue("France");
cells["A3"].PutValue("Germany");
cells["A4"].PutValue("England");
cells["A5"].PutValue("Sweden");
cells["A6"].PutValue("Italy");
cells["A7"].PutValue("Spain");
cells["A8"].PutValue("Portugal");

cells["B1"].PutValue("Sales");
cells["B2"].PutValue(70000);
cells["B3"].PutValue(55000);
cells["B4"].PutValue(30000);
cells["B5"].PutValue(40000);
cells["B6"].PutValue(35000);
cells["B7"].PutValue(32000);
cells["B8"].PutValue(10000);

Aqui, estamos adicionando duas colunas: uma para regiões e outra para números de vendas. Esses dados serão representados no gráfico de pizza.

Etapa 3: Adicionar uma planilha de gráfico

Em seguida, vamos adicionar uma planilha separada para armazenar o gráfico de pizza.

int sheetIndex = workbook.Worksheets.Add(SheetType.Chart);
Worksheet chartSheet = workbook.Worksheets[sheetIndex];
chartSheet.Name = "Chart";

Esta nova planilha hospedará o gráfico de pizza. Dar a ele um nome como “Gráfico” garante que os usuários saibam o que esperar quando abrirem o arquivo.

Etapa 4: Crie o gráfico de pizza

Agora é hora de criar o gráfico real. Especificaremos que queremos um gráfico de pizza e definiremos sua posição na planilha.

int chartIndex = chartSheet.Charts.Add(Aspose.Cells.Charts.ChartType.Pie, 5, 0, 25, 10);
Aspose.Cells.Charts.Chart chart = chartSheet.Charts[chartIndex];

O métodoAdd()aceita parâmetros para o tipo de gráfico (neste caso,ChartType.Pie), e sua localização na planilha. Os números representam posições de linha e coluna.

Etapa 5: personalizar a aparência do gráfico

Um gráfico de pizza não estaria completo sem alguma personalização! Vamos tornar nosso gráfico visualmente atraente ajustando as cores, rótulos e título.

Definir título do gráfico

chart.Title.Text = "Sales By Region";
chart.Title.Font.Color = Color.Blue;
chart.Title.Font.IsBold = true;
chart.Title.Font.Size = 12;

Personalizar área de plotagem

chart.PlotArea.Area.ForegroundColor = Color.Coral;
chart.PlotArea.Area.FillFormat.SetTwoColorGradient(Color.Yellow, Color.White, GradientStyleType.Vertical, 2);
chart.PlotArea.Border.IsVisible = false;

Definimos o preenchimento de gradiente para a área de plotagem e ocultamos a borda para uma aparência mais limpa.

Etapa 6: Definir dados do gráfico

É hora de vincular o gráfico aos nossos dados. ONSeries propriedade do gráfico vincula os números de vendas e regiões ao gráfico de pizza.

chart.NSeries.Add("Data!B2:B8", true);
chart.NSeries.CategoryData = "Data!A2:A8";
chart.NSeries.IsColorVaried = true;

A primeira linha especifica que estamos usando os dados de vendas das célulasB2:B8 . Também informamos ao gráfico para usar os nomes das regiões deA2:A8 como rótulos de categoria.

Etapa 7: Adicionar rótulos de dados

Adicionar rótulos diretamente aos segmentos do gráfico pode facilitar o entendimento. Vamos incluir os nomes das regiões e os valores de vendas dentro das fatias do gráfico de pizza.

for (int i = 0; i < chart.NSeries.Count; i++)
{
    DataLabels labels = chart.NSeries[i].DataLabels;
    labels.ShowCategoryName = true;
    labels.ShowValue = true;
    labels.Position = LabelPositionType.InsideBase;
}

Etapa 8: personalizar a área do gráfico e a legenda

Por fim, vamos dar alguns toques finais à área do gráfico e à legenda. Isso melhora a apresentação geral do gráfico.

Área do gráfico

ChartArea chartArea = chart.ChartArea;
chartArea.Area.Formatting = FormattingType.Custom;
chartArea.Area.FillFormat.Texture = TextureType.BlueTissuePaper;

Lenda

Legend legend = chart.Legend;
legend.Position = LegendPositionType.Left;
legend.Font.IsBold = true;
legend.Border.Color = Color.Blue;
legend.Area.FillFormat.Texture = TextureType.Bouquet;

Etapa 9: Salve a pasta de trabalho

Por fim, salvamos a pasta de trabalho em um arquivo Excel. Você pode especificar o diretório de saída e o nome do arquivo conforme necessário.

workbook.Save(outputDir + "outputHowToCreatePieChart.xlsx");

Conclusão

Criar um gráfico de pizza com o Aspose.Cells para .NET é um processo simples e personalizável. Seguindo este guia, você pode gerar um gráfico de aparência profissional que transmite insights valiosos em apenas algumas etapas. Seja para relatórios comerciais ou fins educacionais, dominar a criação de gráficos elevará suas habilidades de automação do Excel. Lembre-se, o Aspose.Cells fornece a flexibilidade necessária para criar arquivos Excel impressionantes e orientados a dados sem esforço.

Perguntas frequentes

Posso criar outros tipos de gráficos usando o Aspose.Cells para .NET?

Sim! O Aspose.Cells suporta vários tipos de gráficos, incluindo gráficos de barras, gráficos de linhas e gráficos de dispersão.

Preciso de uma licença paga para usar o Aspose.Cells para .NET?

Você pode usar a versão gratuita com algumas limitações. Para recursos completos, você precisará de uma licença, que pode ser compradaaqui.

Posso exportar o gráfico para formatos como PDF ou imagens?

Absolutamente! O Aspose.Cells permite que você exporte gráficos para vários formatos, incluindo PDF e PNG.

É possível estilizar cada fatia de torta com cores diferentes?

Sim, você pode aplicar cores diferentes a cada fatia definindo oIsColorVaried propriedade paratrue, conforme mostrado no tutorial.

Posso automatizar a geração de vários gráficos em uma única pasta de trabalho?

Sim, você pode criar e personalizar quantos gráficos forem necessários em um único arquivo do Excel.

Criar gráfico de linhas Criar gráfico de pirâmide