Сгенерируйте диаграмму, обработав интеллектуальные маркеры

Aspose.Cells API предоставляютWorkbookDesignerкласс для работы со смарт-маркерами, где форматирование и формулы помещаются в электронные таблицы конструктора, а затем обрабатываются с помощьюWorkbookDesignerкласс для заполнения данных в соответствии с указанными смарт-маркерами. Также можно создавать диаграммы Excel, обрабатывая смарт-маркеры, для чего потребуются следующие шаги.

Создание дизайнерской таблицы
Электронная таблица конструктора обработки для указанного источника данных
Создание диаграммы на основе заполненных данных

Создание электронной таблицы конструктора

Электронная таблица дизайнера — это простой файл Excel, созданный с помощью приложения Excel Microsoft или API-интерфейсов Aspose.Cells, содержащий визуальное форматирование, формулы и интеллектуальные маркеры, содержимое которых может быть заполнено во время выполнения.

Для простоты мы создадим электронную таблицу дизайнера, используя Aspose.Cells for .NET API, а затем обработаем ее с помощью динамически созданного источника данных в демонстрационных целях.

	// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
	// The path to the documents directory.
	string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

	// Create an instance of Workbook
	var book = new Workbook();

	// Access the first, default Worksheet by passing its index
	var dataSheet = book.Worksheets[0];

	// Name the Worksheet for later reference
	dataSheet.Name = "ChartData";

	// Access the CellsCollection of first Worksheet
	var cells = dataSheet.Cells;

	// Insert static data (headers)
	cells["B1"].PutValue("Item 1");
	cells["C1"].PutValue("Item 2");
	cells["D1"].PutValue("Item 3");
	cells["E1"].PutValue("Item 4");
	cells["F1"].PutValue("Item 5");
	cells["G1"].PutValue("Item 6");
	cells["H1"].PutValue("Item 7");
	cells["I1"].PutValue("Item 8");
	cells["J1"].PutValue("Item 9");
	cells["K1"].PutValue("Item 10");
	cells["L1"].PutValue("Item 11");
	cells["M1"].PutValue("Item 12");


	// Place Smart Markers
	cells["A2"].PutValue("&=Sales.Year");
	cells["B2"].PutValue("&=Sales.Item1");
	cells["C2"].PutValue("&=Sales.Item2");
	cells["D2"].PutValue("&=Sales.Item3");
	cells["E2"].PutValue("&=Sales.Item4");
	cells["F2"].PutValue("&=Sales.Item5");
	cells["G2"].PutValue("&=Sales.Item6");
	cells["H2"].PutValue("&=Sales.Item7");
	cells["I2"].PutValue("&=Sales.Item8");
	cells["J2"].PutValue("&=Sales.Item9");
	cells["K2"].PutValue("&=Sales.Item10");
	cells["L2"].PutValue("&=Sales.Item11");
	cells["M2"].PutValue("&=Sales.Item12");

view raw Examples-CSharp-Articles-ManageChartsAndShapes-GenerateChartByProcessingSmartMarkers-CreationOfDesignerSpreadsheet.cs hosted with ❤ by GitHub

Электронная таблица дизайнера обработки

Для обработки электронной таблицы дизайнера необходимо иметь источник данных, соответствующий смарт-маркерам, используемым в электронной таблице дизайнера. Например, мы создали запись Smart Marker как &=Sales.Year, которая представляет столбец Year в DataTable Sales. Если соответствующий столбец недоступен в источнике данных, API-интерфейсы Aspose.Cells пропустят обработку для этого конкретного смарт-маркера, и в результате данные для конкретного смарт-маркера не будут заполнены.

Чтобы продемонстрировать этот вариант использования, мы создадим источник данных с нуля и обработаем его с помощью электронной таблицы дизайнера, созданной на предыдущем шаге. Однако в сценарии реального времени данные могут уже быть доступны для дальнейшей обработки, поэтому вы можете пропустить создание источника данных, если данные уже доступны.

	// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
	// Create an instance of DataTable and name is according to the Smart Markers
	var table = new DataTable("Sales");
	/*
	* Add columns to the newly created DataTable while specifying the column type
	* It is important that the DataTable should have at least one column for each
	* Smart Marker entry from the designer spreadsheet
	*/
	table.Columns.Add("Year", typeof(string));
	table.Columns.Add("Item1", typeof(int));
	table.Columns.Add("Item2", typeof(int));
	table.Columns.Add("Item3", typeof(int));
	table.Columns.Add("Item4", typeof(int));
	table.Columns.Add("Item5", typeof(int));
	table.Columns.Add("Item6", typeof(int));
	table.Columns.Add("Item7", typeof(int));
	table.Columns.Add("Item8", typeof(int));
	table.Columns.Add("Item9", typeof(int));
	table.Columns.Add("Item10", typeof(int));
	table.Columns.Add("Item11", typeof(int));
	table.Columns.Add("Item12", typeof(int));

	// Add some rows with data to the DataTable
	table.Rows.Add("2000", 2310, 0, 110, 15, 20, 25, 30, 1222, 200, 421, 210, 133);
	table.Rows.Add("2005", 1508, 0, 170, 280, 190, 400, 105, 132, 303, 199, 120, 100);
	table.Rows.Add("2010", 0, 210, 230, 140, 150, 160, 170, 110, 1999, 1229, 1120, 2300);
	table.Rows.Add("2015", 3818, 320, 340, 260, 210, 310, 220, 0, 0, 0, 0, 122);

view raw Examples-CSharp-Articles-ManageChartsAndShapes-GenerateChartByProcessingSmartMarkers-ProcessingDesignerSpreadsheet.cs hosted with ❤ by GitHub

Обработка интеллектуальных маркеров довольно проста, как показано в следующем фрагменте кода.

	// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET

	// The path to the documents directory.
	string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

	// Create an instance of Workbook
	var book = new Workbook();

	// Access the first, default Worksheet by passing its index
	var dataSheet = book.Worksheets[0];

	// Name the Worksheet for later reference
	dataSheet.Name = "ChartData";

	// Access the CellsCollection of first Worksheet
	var cells = dataSheet.Cells;

	// Insert static data (headers)
	cells["B1"].PutValue("Item 1");
	cells["C1"].PutValue("Item 2");
	cells["D1"].PutValue("Item 3");
	cells["E1"].PutValue("Item 4");
	cells["F1"].PutValue("Item 5");
	cells["G1"].PutValue("Item 6");
	cells["H1"].PutValue("Item 7");
	cells["I1"].PutValue("Item 8");
	cells["J1"].PutValue("Item 9");
	cells["K1"].PutValue("Item 10");
	cells["L1"].PutValue("Item 11");
	cells["M1"].PutValue("Item 12");


	// Place Smart Markers
	cells["A2"].PutValue("&=Sales.Year");
	cells["B2"].PutValue("&=Sales.Item1");
	cells["C2"].PutValue("&=Sales.Item2");
	cells["D2"].PutValue("&=Sales.Item3");
	cells["E2"].PutValue("&=Sales.Item4");
	cells["F2"].PutValue("&=Sales.Item5");
	cells["G2"].PutValue("&=Sales.Item6");
	cells["H2"].PutValue("&=Sales.Item7");
	cells["I2"].PutValue("&=Sales.Item8");
	cells["J2"].PutValue("&=Sales.Item9");
	cells["K2"].PutValue("&=Sales.Item10");
	cells["L2"].PutValue("&=Sales.Item11");
	cells["M2"].PutValue("&=Sales.Item12");

	// Create an instance of DataTable and name is according to the Smart Markers
	var table = new DataTable("Sales");
	/*
	* Add columns to the newly created DataTable while specifying the column type
	* It is important that the DataTable should have at least one column for each
	* Smart Marker entry from the designer spreadsheet
	*/
	table.Columns.Add("Year", typeof(string));
	table.Columns.Add("Item1", typeof(int));
	table.Columns.Add("Item2", typeof(int));
	table.Columns.Add("Item3", typeof(int));
	table.Columns.Add("Item4", typeof(int));
	table.Columns.Add("Item5", typeof(int));
	table.Columns.Add("Item6", typeof(int));
	table.Columns.Add("Item7", typeof(int));
	table.Columns.Add("Item8", typeof(int));
	table.Columns.Add("Item9", typeof(int));
	table.Columns.Add("Item10", typeof(int));
	table.Columns.Add("Item11", typeof(int));
	table.Columns.Add("Item12", typeof(int));

	// Add some rows with data to the DataTable
	table.Rows.Add("2000", 2310, 0, 110, 15, 20, 25, 30, 1222, 200, 421, 210, 133);
	table.Rows.Add("2005", 1508, 0, 170, 280, 190, 400, 105, 132, 303, 199, 120, 100);
	table.Rows.Add("2010", 0, 210, 230, 140, 150, 160, 170, 110, 1999, 1229, 1120, 2300);
	table.Rows.Add("2015", 3818, 320, 340, 260, 210, 310, 220, 0, 0, 0, 0, 122);

	// Create an instance of WorkbookDesigner class
	var designer = new WorkbookDesigner();

	// Assign the Workbook property to the instance of Workbook created in first step
	designer.Workbook = book;

	// Set the data source
	designer.SetDataSource(table);

	// Call Process method to populate data
	designer.Process();

view raw Examples-CSharp-Articles-ManageChartsAndShapes-GenerateChartByProcessingSmartMarkers-ProcessingOfSmartMarkers.cs hosted with ❤ by GitHub

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

Создание диаграммы

Как только данные будут на месте, все, что нам нужно сделать, это создать диаграмму на основе источника данных. Чтобы не усложнять пример, мы будем использоватьДиаграмма.SetChartDataRangeметод, чтобы нам не пришлось дополнительно настраивать диаграмму.

	// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET

	// The path to the documents directory.
	string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

	// Create an instance of Workbook
	var book = new Workbook();

	// Access the first, default Worksheet by passing its index
	var dataSheet = book.Worksheets[0];

	// Name the Worksheet for later reference
	dataSheet.Name = "ChartData";

	// Access the CellsCollection of first Worksheet
	var cells = dataSheet.Cells;

	// Insert static data (headers)
	cells["B1"].PutValue("Item 1");
	cells["C1"].PutValue("Item 2");
	cells["D1"].PutValue("Item 3");
	cells["E1"].PutValue("Item 4");
	cells["F1"].PutValue("Item 5");
	cells["G1"].PutValue("Item 6");
	cells["H1"].PutValue("Item 7");
	cells["I1"].PutValue("Item 8");
	cells["J1"].PutValue("Item 9");
	cells["K1"].PutValue("Item 10");
	cells["L1"].PutValue("Item 11");
	cells["M1"].PutValue("Item 12");


	// Place Smart Markers
	cells["A2"].PutValue("&=Sales.Year");
	cells["B2"].PutValue("&=Sales.Item1");
	cells["C2"].PutValue("&=Sales.Item2");
	cells["D2"].PutValue("&=Sales.Item3");
	cells["E2"].PutValue("&=Sales.Item4");
	cells["F2"].PutValue("&=Sales.Item5");
	cells["G2"].PutValue("&=Sales.Item6");
	cells["H2"].PutValue("&=Sales.Item7");
	cells["I2"].PutValue("&=Sales.Item8");
	cells["J2"].PutValue("&=Sales.Item9");
	cells["K2"].PutValue("&=Sales.Item10");
	cells["L2"].PutValue("&=Sales.Item11");
	cells["M2"].PutValue("&=Sales.Item12");

	// Create an instance of DataTable and name is according to the Smart Markers
	var table = new DataTable("Sales");
	/*
	* Add columns to the newly created DataTable while specifying the column type
	* It is important that the DataTable should have at least one column for each
	* Smart Marker entry from the designer spreadsheet
	*/
	table.Columns.Add("Year", typeof(string));
	table.Columns.Add("Item1", typeof(int));
	table.Columns.Add("Item2", typeof(int));
	table.Columns.Add("Item3", typeof(int));
	table.Columns.Add("Item4", typeof(int));
	table.Columns.Add("Item5", typeof(int));
	table.Columns.Add("Item6", typeof(int));
	table.Columns.Add("Item7", typeof(int));
	table.Columns.Add("Item8", typeof(int));
	table.Columns.Add("Item9", typeof(int));
	table.Columns.Add("Item10", typeof(int));
	table.Columns.Add("Item11", typeof(int));
	table.Columns.Add("Item12", typeof(int));

	// Add some rows with data to the DataTable
	table.Rows.Add("2000", 2310, 0, 110, 15, 20, 25, 30, 1222, 200, 421, 210, 133);
	table.Rows.Add("2005", 1508, 0, 170, 280, 190, 400, 105, 132, 303, 199, 120, 100);
	table.Rows.Add("2010", 0, 210, 230, 140, 150, 160, 170, 110, 1999, 1229, 1120, 2300);
	table.Rows.Add("2015", 3818, 320, 340, 260, 210, 310, 220, 0, 0, 0, 0, 122);

	// Create an instance of WorkbookDesigner class
	var designer = new WorkbookDesigner();

	// Assign the Workbook property to the instance of Workbook created in first step
	designer.Workbook = book;

	// Set the data source
	designer.SetDataSource(table);

	// Call Process method to populate data
	designer.Process();

	/*
	* Save the number of rows & columns from the source DataTable in seperate variables.
	* These values will be used later to identify the chart's data range from DataSheet
	*/
	int chartRows = table.Rows.Count;
	int chartCols = table.Columns.Count;

	// Add a new Worksheet of type Chart to Workbook
	int chartSheetIdx = book.Worksheets.Add(SheetType.Chart);

	// Access the newly added Worksheet via its index
	var chartSheet = book.Worksheets[chartSheetIdx];

	// Name the Worksheet
	chartSheet.Name = "Chart";

	// Add a chart of type ColumnStacked to newly added Worksheet
	int chartIdx = chartSheet.Charts.Add(ChartType.ColumnStacked, 0, 0, chartRows, chartCols);

	// Access the newly added Chart via its index
	var chart = chartSheet.Charts[chartIdx];

	// Set the data range for the chart
	chart.SetChartDataRange(dataSheet.Name + "!A1:" + CellsHelper.ColumnIndexToName(chartCols - 1) + (chartRows + 1).ToString(), false);

	// Set the chart to size with window
	chart.SizeWithWindow = true;

	// Set the format for the tick labels
	chart.ValueAxis.TickLabels.NumberFormat = "$###,### K";

	// Set chart title
	chart.Title.Text = "Sales Summary";

	// Set ChartSheet an active sheet
	book.Worksheets.ActiveSheetIndex = chartSheetIdx;

	// Save the final result
	book.Save(dataDir + "report_out.xlsx");

view raw Examples-CSharp-Articles-ManageChartsAndShapes-GenerateChartByProcessingSmartMarkers-CreationOfChart.cs hosted with ❤ by GitHub

Получить рабочий лист диаграммы