Visualizar dados hierárquicos com um efeito tridimensional pode tornar os relatórios mais envolventes. Neste guia, você aprenderá como criar um gráfico PyramidColumn3D no Excel programaticamente usando C# e Aspose.Cells for .NET. O exemplo demonstra como adicionar dados, inserir o gráfico, ajustar as configurações da série e exportar a pasta de trabalho para um arquivo Excel.
Este artigo cobre os seguintes tópicos:
- Biblioteca Aspose.Cells .NET para Gráficos PyramidColumn3D
- Criar um Gráfico PyramidColumn3D Básico
- Personalizar o Gráfico PyramidColumn3D (Cores, Eixo, Legenda)
- Informações da Licença Gratuita
- Recursos Adicionais
- Conclusão
- Veja Também
Aspose.Cells .NET Library para Gráficos PyramidColumn3D
Aspose.Cells for .NET é uma API poderosa e totalmente gerenciada que permite aos desenvolvedores criar, modificar e renderizar arquivos Excel sem o Microsoft Office. Ela suporta toda a gama de tipos de gráficos do Excel, incluindo o gráfico PyramidColumn3D.
Principais vantagens de usar Aspose.Cells:
- Rich Chart API – Acesso direto a objetos de gráfico, séries, eixos, legendas e formatação.
- No Interop Dependency – Funciona em qualquer ambiente .NET (Desktop, Server, Cloud).
- High Performance – Lida com grandes pastas de trabalho com baixo consumo de memória.
- Multiple Formats – Salva em XLSX, XLS, CSV, PDF, HTML e formatos de imagem.
Para começar a usar Aspose.Cells, instale o pacote NuGet:
PM> Install-Package Aspose.Cells
Criar um Gráfico PyramidColumn3D Básico
O exemplo a seguir cria uma planilha simples, preenche‑a com dados de exemplo, adiciona um gráfico PyramidColumn3D e salva o arquivo como PyramidColumn3D_Basic.xlsx.
Explicação das etapas principais
| Etapa | O que faz |
|---|---|
| 1 | Instancia um Workbook e acessa a primeira Worksheet. |
| 2 | Preenche a planilha com nomes de produtos e valores de vendas trimestrais. |
| 3 | Chama Charts.Add com ChartType.PyramidColumn3D para criar o gráfico de colunas pirâmide 3‑D. |
| 4 | Adiciona a série de dados (NSeries.Add) e define os rótulos de categoria (eixo X). |
| 5 | Salva a pasta de trabalho em um arquivo XLSX que pode ser aberto no Microsoft Excel. |
Executar o programa gera um arquivo Excel contendo um gráfico de colunas pirâmide 3‑D que visualiza os dados de vendas ao longo de quatro trimestres.
Personalize o Gráfico PyramidColumn3D (Cores, Eixo, Legenda)
Frequentemente, você precisa ajustar a aparência do gráfico para combinar com a identidade corporativa ou melhorar a legibilidade. O exemplo abaixo demonstra:
- Alterando cores de preenchimento das colunas.
- Ajustando a posição da legenda.
- Modificando os títulos dos eixos primário e secundário.
- Habilitando rótulos de dados.
O que o código personalizado faz
| Personalização | Code snippet | Resultado |
|---|---|---|
| Cores das séries | chart.NSeries[s].Area.ForegroundColor = palette[s]; | A coluna de cada ano aparece em uma cor distinta, compatível com a marca. |
| Rótulos de dados | chart.NSeries[s].DataLabels.IsValueShown = true; | Valores numéricos são exibidos acima de cada coluna para uma visão rápida. |
| Posicionamento da legenda | chart.Legend.Position = LegendPositionType.Bottom; | Legenda posicionada abaixo do gráfico, liberando a área do gráfico. |
| Títulos dos eixos e formato numérico | chart.CategoryAxis.Title.Text, chart.ValueAxis.NumberFormat | Melhora a legibilidade e indica as unidades. |
| Remoção de borda | chart.NSeries[s].Border.IsVisible = false; | Proporciona uma aparência 3‑D mais limpa. |
Abra PyramidColumn3D_Customized.xlsx no Excel para ver um gráfico refinado, pronto para apresentação.
Obtenha uma Licença Gratuita
Aspose.Cells requer uma licença para funcionalidade completa. Você pode obter uma licença temporária gratuita para avaliação no portal da Aspose:
Licença Temporária Gratuita para Aspose.Cells
Aplique a licença antes de gerar gráficos em um ambiente de produção para remover as marcas d’água de avaliação.
// Example of applying a license (place this at the start of your program)
var license = new Aspose.Cells.License();
license.SetLicense("Aspose.Total.lic"); // Path to your .lic file
Recursos Adicionais
- Guia do Desenvolvedor – Visão geral completa de todos os recursos de gráficos: https://docs.aspose.com/cells/net/
- Referência da API – Documentação detalhada de classes e métodos: https://reference.aspose.com/cells/net/
- Aplicativos Online Gratuitos – Experimente a geração de gráficos sem código: https://products.aspose.app/cells/family
- Fórum de Suporte – Faça perguntas e compartilhe trechos de código: https://forum.aspose.com/c/cells/9
Conclusão
Criar um gráfico PyramidColumn3D com Aspose.Cells for .NET é simples:
- Preencher os dados da planilha.
- Adicionar um gráfico
ChartType.PyramidColumn3D. - Definir séries, categorias e formatação opcional.
- Salvar a pasta de trabalho.
A biblioteca oferece controle total sobre a estética dos gráficos, permitindo que você produza visualizações de nível profissional diretamente de suas aplicações C#.
Se precisar de mais assistência, sinta‑se à vontade para participar dos fóruns da comunidade Aspose ou explorar a extensa documentação vinculada acima.