如何使用 C# 程序化创建和自动化 PowerPoint 演示文稿

每周手动创建相同的 PowerPoint 演示文稿是一项乏味、容易出错的任务，没有哪个开发人员喜欢这样做。 无论是生成每周销售报告、每月财务摘要，还是个性化客户建议书，自动化流程的时机已经成熟。 多年来，.NET 领域的首选解决方案是 Microsoft Office Interop，这是一种允许对 Office 应用程序进行编程控制的技术。 不过，这种方法也有很大的缺点：它需要在服务器上安装 Microsoft Office 的授权版本，在服务器环境中不稳定是众所周知的，而且它完全排除了在 Linux、macOS 或 Docker 容器中进行现代跨平台部署的可能性。

幸运的是，有一种更好的方法。 本教程将向您展示如何使用 IronPPT for .NET 以编程方式在 C# 中创建 PowerPoint 演示文稿，IronPPT for .NET 是一个专为现代开发而构建的功能强大的轻量级库。 我们将探讨如何自动完成从创建简单的幻灯片到从模板生成复杂的数据驱动型演示文稿（包括表格和图表）的所有工作。 有了 IronPPT，您可以构建快速、可扩展和可靠的演示自动化工作流程，这些流程可在任何地方运行，而无需依赖 Microsoft Office。

!a href="/static-assets/pdf/blog/csharp-create-powerpoint-tutorial/csharp-create-powerpoint-tutorial-1.webp">IronPPT - C# 演示文稿库。 _The IronPPT for .NET library allows developers to programmatically create and manage PowerPoint files in C#._The IronPPT for .NET library 允许开发人员用 C# 编程创建和管理 PowerPoint 文件。

如何开始在 C# 中生成 PowerPoint？ C# PowerPoint 自动化入门简单明了。IronPPT for.NET以 NuGet 软件包的形式发布，可在几秒钟内直接安装到您的 Visual Studio 项目中。

步骤 1：安装 IronPPT 库

工具 > <代码>NuGet 软件包管理器 > <代码>软件包管理器控制台）并输入以下命令： ```shell :ProductInstall ``` 或者，您也可以在 NuGet 软件包管理器图形用户界面中搜索 "IronPPT"，然后从那里进行安装。 !a href="/static-assets/pdf/blog/csharp-create-powerpoint-tutorial/csharp-create-powerpoint-tutorial-2.webp"> 通过 NuGet 包管理器屏幕安装 IronPPT Visual Studio 中的 NuGet 包管理器，显示 IronPPT 库的安装____。

步骤 2：创建并保存您的第一个演示

如何以编程方式添加和操作幻灯片？ 演示文稿是幻灯片的集合。 IronPPT 为管理这些幻灯片提供了简单直观的 API，允许您[根据应用需要添加、加载和重用](/csharp/ppt/examples/add-slide/)这些幻灯片。

加载现有演示文稿并添加幻灯片

克隆幻灯片以实现一致的布局向幻灯片添加丰富内容的最佳方法是什么？ 有了幻灯片后，下一步就是填充有意义的内容。 IronPPT 提供丰富的对象模型，用于添加和格式化文本、插入图像和绘制形状。

处理文本、字体和段落

形状（充当文本框）、<代码>段落和<代码>文本。 这种结构可以对定位和样式进行细化控制。 让我们在两张幻灯片演示文稿的基础上进行扩展，在第一张幻灯片上添加样式标题，在第二张幻灯片上添加列表。 ```csharp using IronPPT; using IronPPT.Enums; using System.Drawing; // Load the presentation with two slides var presentation = new PresentationDocument("PresentationWithTwoSlides.pptx"); // ---Modify the First Slide --- Slide firstSlide = presentation.Slides; // Clear existing text if any firstSlide.ClearText(); // Add a title to the first slide. By default, AddText creates a textbox. // For more control, we can create a Shape and add text to it. Shape titleShape = firstSlide.AddShape(ShapeType.Rectangle, new Rectangle(50, 50, 860, 100)); titleShape.Fill.SetSolid(new Color("#003B5C")); // A dark blue background Paragraph titleParagraph = titleShape.AddParagraph("Welcome to IronPPT"); titleParagraph.DefaultTextStyle.SetFont("Arial", 44).SetColor(Color.White).SetBold(true); titleParagraph.Style.SetAlignment(TextAlignmentTypeValues.Center); // ---Modify the Second Slide --- Slide secondSlide = presentation.Slides; secondSlide.AddText("Key Features", new Rectangle(50, 30, 860, 70)) .DefaultTextStyle.SetFont("Calibri", 36).SetBold(true); // Create a shape to act as a textbox for our bulleted list Shape listShape = secondSlide.AddShape(ShapeType.Rectangle, new Rectangle(70, 120, 800, 300)); // Add a bulleted list listShape.AddParagraph("Create presentations programmatically").Style.SetBullet(BulletType.Numeric); listShape.AddParagraph("Add text, images, and shapes").Style.SetBullet(BulletType.Numeric); listShape.AddParagraph("Style content with fonts, colors, and alignment").Style.SetBullet(BulletType.Numeric); listShape.AddParagraph("Generate data-driven reports from templates").Style.SetBullet(BulletType.Numeric); // Style all paragraphs in the list shape foreach (var para in listShape.Paragraphs) { para.DefaultTextStyle.SetFont("Arial", 28); para.Style.SetIndentation(30); // Indent the list } // Save the final presentation presentation.Save("PresentationWithRichContent.pptx"); ``` 本例展示了几个关键概念： - **形状作为文本框**：我们创建一个 `Rectangle` 类型的 `Shape` 作为文本容器。 这使我们能够精确控制其位置和大小。 - **段落**：文本内容通过 `Paragraph` 对象添加。 - **样式**：`段落`的`DefaultTextStyle`属性允许对字体、大小、颜色和重量进行流畅的样式设置。 `Style` 属性可控制段落级格式，如对齐方式和项目符号。 !a href="/static-assets/pdf/blog/csharp-create-powerpoint-tutorial/csharp-create-powerpoint-tutorial-5.webp"> 添加文本和文本框。 第一张幻灯片现在采用了样式化标题，第二张幻灯片包含一个列表。

插入和定位图片

绘制和自定义形状A Styled Circle 第二张幻灯片现在通过 C# 代码添加了一个样式圆。

如何创建数据驱动的演示文稿？ PowerPoint 自动化的真正威力在于从动态数据源生成演示文稿。 这正是 IronPPT 的优势所在，它使您能够构建复杂的报表系统，并能即时创建表格、图表和填充模板。 这种能力使其有别于基本库，并将其定位为 Aspose 和 Syncfusion 等工具的有力竞争者，这些工具也突出了数据驱动功能。

使用模板生成动态报告

步骤 1：创建 PowerPoint 模板步骤 2：在 C# 中填充模板； { { "{{ClientName}}", "Global Tech Inc." }, { "{{ReportDate}}", System.DateTime.Now.ToShortDateString() }, { "{{TotalSales}}", "$1,250,000" }, { "{{PreparedBy}}", "Automated Reporting System" } }; // Load the presentation template var presentation = new PresentationDocument("ReportTemplate.pptx"); Slide reportSlide = presentation.Slides; // Iterate through all shapes on the slide to find and replace text foreach (var shape in reportSlide.Shapes) { // Iterate through all paragraphs within the shape foreach (var paragraph in shape.Paragraphs) { // Iterate through all text runs in the paragraph foreach (var textRun in paragraph.Texts) { foreach (var kvp in reportData) { if (textRun.Value.Contains(kvp.Key)) - textRun.ReplaceText(kvp.Key, kvp.Value); } } } } // Save the generated report presentation.Save("GeneratedClientReport.pptx"); ``` 这种基于模板的方法非常强大。 它将设计与数据分离开来，允许设计人员在 PowerPoint 中修改模板的外观和感觉，而无需修改任何代码。

从数据集合生成表格

` ）中以编程方式创建和填充表格。 假设我们有一个简单的 `Product` 类和一个产品列表。 以下代码将生成一张新幻灯片，其中的表格将显示这些数据。 ```csharp // ---Sample Data Model and Collection --- public class Product { public int ID { get; set; } public string Name { get; set; } public decimal Price { get; set; } public int StockLevel { get; set; } } var products = new List { new Product { ID = 101, Name = "Quantum CPU", Price = 299.99m, StockLevel = 50 }, new Product { ID = 205, Name = "Photon SSD", Price = 149.50m, StockLevel = 120 }, new Product { ID = 310, Name = "Gravity GPU", Price = 799.00m, StockLevel = 25 } }; // ---Table Generation --- var presentation = new PresentationDocument(); var tableSlide = presentation.AddSlide(); tableSlide.AddText("Product Inventory Report", new Rectangle(50, 20, 860, 50)) .DefaultTextStyle.SetFont("Arial", 32).SetBold(true); // Add a table to the slide with 4 columns and (N+1) rows Table productTable = tableSlide.AddTable(products.Count + 1, 4, new Rectangle(50, 100, 860, 300)); // ---Populate Header Row --- productTable.Rows.Cells.TextBody.AddParagraph("Product ID"); productTable.Rows.Cells.TextBody.AddParagraph("Product Name"); productTable.Rows.Cells.TextBody.AddParagraph("Price"); productTable.Rows.Cells.TextBody.AddParagraph("Stock"); // Style the header row foreach (var cell in productTable.Rows.Cells) { cell.Fill.SetSolid(new Color("#4A5568")); // Dark Gray cell.TextBody.Paragraphs.DefaultTextStyle.SetColor(Color.White).SetBold(true); cell.TextBody.Paragraphs.Style.SetAlignment(TextAlignmentTypeValues.Center); } // ---Populate Data Rows --- for (int i = 0; i < products.Count; i++) { var product = products[i]; productTable.Rows[i + 1].Cells.TextBody.AddParagraph(product.ID.ToString()); productTable.Rows[i + 1].Cells.TextBody.AddParagraph(product.Name); productTable.Rows[i + 1].Cells.TextBody.AddParagraph(product.Price.ToString("C")); productTable.Rows[i + 1].Cells.TextBody.AddParagraph(product.StockLevel.ToString()); } presentation.Save("ProductInventoryReport.pptx"); ```

添加图表以可视化数据

为什么选择专用库而不是 Office Interop？ 对于考虑以编程方式制作 PowerPoint 的开发人员来说，通常会选择使用 Microsoft Office Interop 还是 IronPPT 这样的专用第三方库。 虽然 Interop 在拥有 Office 许可证的情况下是 "免费 "的，但它并不是为满足现代服务器端应用程序的需求而设计的。 下表概述了关键差异。 |特点/考虑因素|IronPPT for.NET|Microsoft.Office.Interop.PowerPoint| | ---| ---| ---| |服务器端依赖性要求在服务器上安装 Microsoft Office。| |性能和可扩展性部署复杂性平台支持Windows、Linux、macOS、Docker、Azure、AWS。|仅限 Windows。 不适合现代跨平台部署。 | |API 设计和易用性稳定性企业 PowerPoint 自动化的最佳实践

立即开始使用 IronPPT。

免费开始