criar-gráficos-em-documentos-word-usando-csharp

Como desenvolvedor C#, você pode inserir vários tipos de gráficos em documentos do Word programaticamente. Ajuda a apresentar graficamente seus dados e informações. Neste artigo, você aprenderá como criar gráficos em documentos do Word usando C#.

Os seguintes tópicos são discutidos/abordados neste artigo:

API C# para inserir gráficos em documentos do Word

Para inserir gráficos em arquivos DOCX, usaremos Aspose.Words for .NET API. Ele permite gerar, modificar, converter, renderizar e imprimir arquivos sem utilizar o Microsoft Word diretamente em aplicativos multiplataforma. A API permite que você insira vários tipos de gráfico suportados em documentos do Word programaticamente.

Você pode baixar a DLL da API ou instalá-la usando NuGet.

Install-Package Aspose.Words

Criar gráficos de colunas em documentos do Word

Você pode criar gráficos de colunas em documentos do Word programaticamente seguindo as etapas abaixo:

  • Primeiramente, crie um novo documento usando a classe Document.
  • Agora, crie uma instância da classe DocumentBuilder com o objeto da classe Document.
  • Em seguida, chame o método DocumentBuilder.InsertChart(). Passe ChartType como Column, com height e width como parâmetros de entrada.
  • Obtenha resultados no objeto de classe Shape.
  • Agora, crie uma instância da classe Chart e atribua o objeto Shape.Chart a ela. Fornece acesso às propriedades do gráfico se esta forma tiver um Gráfico.
  • Em seguida, obtenha a coleção de séries de gráficos no objeto ChartSeriesCollection.
  • Crie uma matriz de nomes de categorias.
  • Agora, chame o método ChartSeriesCollection.Add() para adicionar séries de gráficos. Passe nome, array de categorias e valores como parâmetros de entrada. Repita esta etapa para adicionar mais séries.
  • Finalmente, chame o método Document.Save() com o caminho do arquivo de saída para salvar o arquivo.

O exemplo de código a seguir mostra como criar um gráfico de colunas em um documento do Word usando C#.

// Criar um documento
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Adicionar gráfico com dados padrão. Você pode especificar diferentes tipos e tamanhos de gráficos.
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);

// A propriedade Chart de Shape contém todas as opções relacionadas ao gráfico.
Chart chart = shape.Chart;

// Obtenha a coleção de séries de gráficos.
ChartSeriesCollection seriesColl = chart.Series;
// Verifique a contagem de séries.
Console.WriteLine(seriesColl.Count);

// Excluir série gerada padrão.
seriesColl.Clear();

// Crie um array de nomes de categorias, neste exemplo temos duas categorias.
string[] categories = new string[] { "AW Category 1", "AW Category 2" };

// Adicionando novas séries. Observe que os arrays de dados não devem estar vazios e os arrays devem ter o mesmo tamanho.
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 });

// Salve o documento
doc.Save(@"C:\Files\Words\ColumnsChart.docx");
Crie gráficos de colunas em documentos do Word usando C#.

Criar gráficos de colunas em documentos do Word usando C#

Criar gráficos de dispersão em documentos do Word usando C#

Você pode inserir gráficos de dispersão em seus documentos do Word programaticamente seguindo as etapas mencionadas anteriormente. No entanto, você precisa definir ChartType.Scatter no método DocumentBuilder.InsertChart().

O exemplo de código a seguir mostra como criar um gráfico de dispersão em um documento do Word usando C#.

// Criar um novo documento
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insira o gráfico de dispersão.
Shape shape = builder.InsertChart(ChartType.Scatter, 432, 252);
Chart chart = shape.Chart;

// Use essa sobrecarga para adicionar séries a qualquer tipo de gráfico de dispersão.
chart.Series.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });

// Salve o documento
doc.Save(@"C:\Files\Words\ScatterChart.docx");
Crie gráficos de dispersão em documentos do Word usando C#.

Criar gráficos de dispersão em documentos do Word usando C#

Inserir gráficos de área em documentos do Word usando C#

Você pode inserir gráficos de área em documentos do Word programaticamente seguindo as etapas mencionadas anteriormente. No entanto, você precisa definir ChartType.Area no método DocumentBuilder.InsertChart().

O exemplo de código a seguir mostra como criar um gráfico de área em um documento do Word usando C#.

// Criar um novo documento
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Inserir gráfico de área.
Shape shape = builder.InsertChart(ChartType.Area, 432, 252);
Chart chart = shape.Chart;

// Use essa sobrecarga para adicionar séries a qualquer tipo de gráfico de área, radar e estoque.
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 });

// Salve o documento
doc.Save(@"C:\Files\Words\AreaChart.docx");
Insira gráficos de área em documentos do Word usando C#.

Inserir gráficos de área em documentos do Word usando C#

Inserir gráficos de bolhas em documentos do Word usando C#

Você pode inserir gráficos de bolhas em documentos do Word programaticamente seguindo as etapas mencionadas anteriormente. No entanto, você precisa definir ChartType.Bubble no método DocumentBuilder.InsertChart().

O exemplo de código a seguir mostra como criar um gráfico de bolhas em um documento do Word usando C#.

// Criar um novo documento
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insira o gráfico de bolhas.
Shape shape = builder.InsertChart(ChartType.Bubble, 432, 252);
Chart chart = shape.Chart;

// Use essa sobrecarga para adicionar séries a qualquer tipo de gráfico de bolhas.
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 });

// Salve o documento
doc.Save(@"C:\Files\Words\BubbleChart.docx");
Insira gráficos de bolhas em documentos do Word usando C#.

Inserir gráficos de bolhas em documentos do Word usando C#

Obtenha uma licença gratuita

Você pode experimentar a API sem limitações de avaliação solicitando uma licença temporária gratuita.

Conclusão

Neste artigo, você aprendeu como criar gráficos em documentos do Word usando C#. Particularmente, você aprendeu como criar gráficos de coluna, área, bolha e dispersão em documentos do Word programaticamente. Da mesma forma, você pode criar outros tipos de gráficos. Você pode aprender mais sobre Aspose.Words para .NET API usando a documentação. Em caso de qualquer ambiguidade, não hesite em contactar-nos no fórum.

Veja também