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

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

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

• C# API для вставки диаграмм в документы Word
• Создание диаграмм столбцов в документах Word
• Создание точечных диаграмм в документах Word с помощью C#
• Вставка площадных диаграмм в документы Word с помощью C#
• Вставка пузырьковых диаграмм в документы Word с помощью C#

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

Для вставки диаграмм в файлы DOCX мы будем использовать Aspose.Words for .NET API. Он позволяет создавать, изменять, преобразовывать, визуализировать и печатать файлы без использования Microsoft Word непосредственно в кросс-платформенных приложениях. API позволяет программно вставлять различные поддерживаемые типы диаграмм в документы Word.

Вы можете либо скачать DLL API, либо установить его с помощью NuGet.

Install-Package Aspose.Words
копировать

Создание диаграмм столбцов в документах Word

Вы можете программно создавать гистограммы в документах Word, выполнив следующие действия:

• Во-первых, создайте новый документ, используя класс Document.
• Теперь создайте экземпляр класса DocumentBuilder с объектом класса Document.
• Затем вызовите метод DocumentBuilder.InsertChart(). Передайте ChartType как столбец с высотой и шириной в качестве входных параметров.
• Получить результаты в объекте класса Shape.
• Теперь создайте экземпляр класса Chart и назначьте ему объект Shape.Chart. Он обеспечивает доступ к свойствам диаграммы, если эта фигура имеет диаграмму.
• Затем получите коллекцию серий графиков в объекте ChartSeriesCollection.
• Создайте массив имен категорий.
• Теперь вызовите метод ChartSeriesCollection.Add(), чтобы добавить серию диаграмм. Передайте имя, массив категорий и значения в качестве входных параметров. Повторите этот шаг, чтобы добавить больше серий.
• Наконец, вызовите метод Document.Save() с путем к выходному файлу, чтобы сохранить файл.

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

// Создать документ
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Добавьте диаграмму с данными по умолчанию. Вы можете указать различные типы и размеры диаграмм.
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);

// Свойство диаграммы формы содержит все параметры, связанные с диаграммой.
Chart chart = shape.Chart;

// Получите коллекцию серий диаграмм.
ChartSeriesCollection seriesColl = chart.Series;
// Проверьте количество серий.
Console.WriteLine(seriesColl.Count);

// Удалить серию, сгенерированную по умолчанию.
seriesColl.Clear();

// Создайте массив имен категорий, в этом примере у нас есть две категории.
string[] categories = new string[] { "AW Category 1", "AW Category 2" };

// Добавление новых серий. Обратите внимание, что массивы данных не должны быть пустыми, а массивы должны быть одного размера.
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 });

// Сохраните документ
doc.Save(@"C:\Files\Words\ColumnsChart.docx");
копировать

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

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

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

// Создать новый документ
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Вставьте точечную диаграмму.
Shape shape = builder.InsertChart(ChartType.Scatter, 432, 252);
Chart chart = shape.Chart;

// Используйте эту перегруженную версию, чтобы добавить ряды к любому типу точечных диаграмм.
chart.Series.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });

// Сохраните документ
doc.Save(@"C:\Files\Words\ScatterChart.docx");
копировать

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

Вы можете программно вставлять диаграммы с областями в документы Word, выполнив шаги, упомянутые ранее. Однако вам необходимо установить ChartType.Area в методе DocumentBuilder.InsertChart().

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

// Создать новый документ
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Вставить диаграмму с областями.
Shape shape = builder.InsertChart(ChartType.Area, 432, 252);
Chart chart = shape.Chart;

// Используйте эту перегруженную версию, чтобы добавить ряды к любому типу площадных, радарных и биржевых диаграмм.
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 });

// Сохраните документ
doc.Save(@"C:\Files\Words\AreaChart.docx");
копировать

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

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

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

// Создать новый документ
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Вставьте пузырьковую диаграмму.
Shape shape = builder.InsertChart(ChartType.Bubble, 432, 252);
Chart chart = shape.Chart;

// Используйте эту перегруженную версию для добавления серий в пузырьковые диаграммы любого типа.
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 });

// Сохраните документ
doc.Save(@"C:\Files\Words\BubbleChart.docx");
копировать

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

Вы можете попробовать API без ограничений на пробную версию, запросив бесплатную временную лицензию.

Вывод

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

Смотрите также

• Работа с оглавлением в документе Word C#