create-charts-in-word-documents-using-csharp

Диаграммы в Microsoft Word упрощают и делают визуализацию данных эффективной. Они превращают числа в визуальные элементы, помогая вашему контенту выделяться. Вы можете создавать диаграммы непосредственно в Word, чтобы иллюстрировать тенденции, сравнения и многое другое. Выбирайте из столбчатых графиков, круговых диаграмм, линейных графиков и других стилей, чтобы удовлетворить ваши потребности. Microsoft Word имеет встроенные инструменты для создания диаграмм. Однако Aspose.Words для .NET позволяет вам генерировать и встраивать диаграммы программно. Этот блог объясняет как создавать диаграммы в документах Word с использованием C#.

В этой статье рассматриваются следующие темы:

C# API для создания диаграмм в документах Word

Мы будем использовать Aspose.Words для .NET для создания различных типов диаграмм в документах Word. Эта мощная библиотека позволяет вам программно создавать, редактировать и конвертировать файлы Word. Ее надежный API упрощает создание и настройку диаграмм. Разработчики могут бесшовно интегрировать динамическую визуализацию данных в свои рабочие процессы документов. Это отличный инструмент для генерации отчетов или документов с интерактивными диаграммами.

Чтобы начать работу с Aspose.Words для .NET, выполните следующие простые шаги:

  1. Скачайте библиотеку из релизов.
  2. Установите ее через NuGet Package Manager с помощью следующей команды:
    PM> Install-Package Aspose.Words

Создание столбчатой диаграммы в Word

Столбчатые диаграммы отлично подходят для сравнения данных по категориям. Вы можете легко создать столбчатую диаграмму в документе Word, используя Aspose.Words для .NET. Следуйте этим шагам:

  1. Создайте экземпляр класса Document.
  2. Используйте класс DocumentBuilder для построения документа.
  3. Добавьте столбчатую диаграмму с помощью InsertChart(), передав ChartType.Column, width и height в качестве аргументов.
  4. Сохраните результат в объекте Shape.
  5. Создайте экземпляр класса Chart.
  6. Получите коллекцию серий диаграммы с помощью Chart.Series.
  7. Добавьте данные и определите серии диаграммы с помощью метода Add().
  8. Сохраните файл с помощью метода Save().

Ниже приведен фрагмент кода, который демонстрирует как создать столбчатую диаграмму в документе Word с использованием C#.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Add chart with default data. You can specify different chart types and sizes.
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);
// Chart property of Shape contains all chart related options.
Chart chart = shape.Chart;
// Get chart series collection.
ChartSeriesCollection seriesColl = chart.Series;
// Check series count.
Console.WriteLine(seriesColl.Count);
// Delete default generated series.
seriesColl.Clear();
// Create category names array, in this example we have two categories.
string[] categories = new string[] { "AW Category 1", "AW Category 2" };
// Adding new series. Please note, data arrays must not be empty and arrays must be the same size.
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 });
// Save the document
doc.Save("column-chart.docx");
view raw create-charts-in-word-using-csharp_column.cs hosted with ❤ by GitHub
Создание столбчатых диаграмм в документах Word с использованием C#.

Создание столбчатых диаграмм в документах Word с использованием C#

Создание диаграмм рассеяния в документах Word с использованием C#

Диаграммы рассеяния полезны для отображения взаимосвязей между двумя переменными. Чтобы вставить диаграмму рассеяния в документ Word, следуйте предыдущим шагам. Просто установите ChartType.Scatter в методе InsertChart().

Пример кода ниже показывает как создать диаграмму рассеяния в документе Word с использованием C#.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insert Scatter chart.
Shape shape = builder.InsertChart(ChartType.Scatter, 432, 252);
Chart chart = shape.Chart;
// Use this overload to add series to any type of Scatter charts.
chart.Series.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });
// Save the document
doc.Save("scatter-chart.docx");
view raw create-charts-in-word-using-csharp_scatter.cs hosted with ❤ by GitHub
Создание диаграмм рассеяния в документах Word с использованием C#.

Создание диаграмм рассеяния в документах Word с использованием C#

Вставка площадных диаграмм в документы Word с использованием C#

Областные диаграммы подчеркивают величину изменений с течением времени. Чтобы создать областные диаграммы в документах Word, выполните предыдущие шаги. Просто установите ChartType.Area в методе InsertChart().

Пример кода ниже показывает, как создать областную диаграмму в документе Word с использованием C#.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insert Area chart.
Shape shape = builder.InsertChart(ChartType.Area, 432, 252);
Chart chart = shape.Chart;
// Use this overload to add series to any type of Area, Radar and Stock charts.
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 });
// Save the document
doc.Save("area-chart.docx");
view raw create-charts-in-word-using-csharp_area.cs hosted with ❤ by GitHub
Вставка областных диаграмм в документы Word с использованием C#.

Вставка областных диаграмм в документы Word с использованием C#

Вставка пузырьковых диаграмм в документы Word с использованием C#

Пузырьковые диаграммы идеально подходят для отображения трех измерений данных. Выполните предыдущие шаги, чтобы создать пузырьковые диаграммы в документах Word. Просто установите ChartType.Bubble в методе InsertChart().

Пример кода ниже демонстрирует, как создать пузырьковую диаграмму в документе Word с использованием C#.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insert Bubble chart.
Shape shape = builder.InsertChart(ChartType.Bubble, 432, 252);
Chart chart = shape.Chart;
// Use this overload to add series to any type of Bubble charts.
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 });
// Save the document
doc.Save("bubble-chart.docx");
view raw create-charts-in-word-using-csharp_bubble.cs hosted with ❤ by GitHub
Вставка пузырьковых диаграмм в документы Word с использованием C#.

Вставка пузырьковых диаграмм в документы Word с использованием C#

Создание линейных диаграмм в документах Word с использованием C#

Линейные диаграммы полезны для отображения тенденций данных с течением времени. Чтобы создать линейную диаграмму в документе Word, выполните предыдущие шаги. Просто установите ChartType.Line в методе InsertChart().

Пример кода ниже демонстрирует, как создать линейную диаграмму в документе Word с использованием C#.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
// Determines whether the title shall be shown for this chart. Default is true.
chart.Title.Show = true;
// Setting chart Title.
chart.Title.Text = "Sample Line Chart Title";
// Determines whether other chart elements shall be allowed to overlap title.
chart.Title.Overlay = false;
// Please note if null or empty value is specified as title text, auto generated title will be shown.
// Determines how legend shall be shown for this chart.
chart.Legend.Position = LegendPosition.Left;
chart.Legend.Overlay = true;
// Save the document
doc.Save("line-chart.docx");
view raw create-charts-in-word-using-csharp_line.cs hosted with ❤ by GitHub
Вставка линейных диаграмм в документы Word с использованием C#.

Вставка линейных диаграмм в документы Word с использованием C#

Получите бесплатную лицензию

Откройте весь потенциал Aspose.Words для .NET! Получите бесплатную временную лицензию сегодня и начните использовать её. Наслаждайтесь неограниченными возможностями работы с документами.

Диаграммы в документах Word – Полезные ресурсы

Кроме работы с диаграммами в документах Word, изучите дополнительные возможности Aspose.Words для .NET для дальнейшей настройки диаграмм и документов. Ознакомьтесь с ресурсами ниже:

Заключение

В этой статье мы рассмотрели, как создать различные типы диаграмм — столбчатые, точечные, областные и пузырьковые диаграммы — в документах Word с использованием C#. Мы продемонстрировали, как использовать Aspose.Words для .NET для создания и настройки диаграмм. Следуя этим шагам, вы легко можете добавить визуально привлекательные диаграммы в ваши документы Word, улучшая анализ данных и презентации.

Если у вас возникли вопросы, не стесняйтесь обращаться к нам на нашем бесплатном форуме поддержки для получения помощи.

См. также