วิธีสร้างงานนำเสนอใน .NET

Aspose.Slides FOSS for .NET lets you create PowerPoint presentations entirely in C# with no dependency on Microsoft Office. This guide shows how to create a new presentation, add slides and shapes, format text, and save the result.

คู่มือแบบขั้นตอนต่อขั้นตอน

ขั้นตอนที่ 1: ติดตั้งแพ็กเกจ

ติดตั้ง Aspose.Slides FOSS จาก NuGet จำเป็นต้องใช้ .NET 9.0 หรือใหม่กว่า.

dotnet add package Aspose.Slides.Foss

ตรวจสอบการติดตั้ง:

using Aspose.Slides.Foss;

using var prs = new Presentation();
Console.WriteLine("Aspose.Slides FOSS ready");

ไม่ต้องการแพ็กเกจระบบอื่นใด.

ขั้นตอนที่ 2: นำเข้า Namespaces ที่จำเป็น

เพิ่ม namespaces ที่จำเป็นสำหรับการสร้างและบันทึกงานนำเสนอ.

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

ค่าสถิตประเภทรูปทรงทั้งหมดอยู่ใน Aspose.Slides.Foss.ShapeType. ประเภทการจัดรูปแบบทั้งหมด (FillType, NullableBool) ก็อยู่ใน Aspose.Slides.Foss.

ขั้นตอนที่ 3: สร้างงานนำเสนอ

ใช้ new Presentation() กับ a using คำสั่ง. การนำเสนอใหม่เริ่มต้นด้วยสไลด์เปล่า 1 แผ่น.

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
Console.WriteLine($"Slides in new presentation: {prs.Slides.Count}");
// work with prs
prs.Save("output.pptx", SaveFormat.Pptx);

สำคัญ: ใช้เสมอ Presentation กับ a using คำสั่ง. คลาสนี้ implements IDisposable และทรัพยากรจะไม่ถูกปล่อยอย่างถูกต้องหากไม่มีมัน.

ขั้นตอนที่ 4: เข้าถึงสไลด์

สไลด์แรกอยู่ที่ดัชนี 0 งานนำเสนอเปล่ามีสไลด์เพียงหนึ่งแผ่นเท่านั้น.

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];  // zero-based index
Console.WriteLine($"Slide at index 0: {slide}");
prs.Save("output.pptx", SaveFormat.Pptx);

ขั้นตอนที่ 5: เพิ่มรูปร่าง

ใช้ slide.Shapes.AddAutoShape() เพื่อเพิ่ม AutoShape. พารามิเตอร์คือ (shapeType, x, y, width, height) ทั้งหมดเป็นหน่วยจุด (1 จุด = 1/72 นิ้ว; สไลด์มาตรฐานคือ 720 x 540 pt).

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];

// Rectangle at (50, 50) with 400 wide and 120 tall
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 400, 120);

// Attach a text frame
shape.AddTextFrame("Hello from Aspose.Slides FOSS!");

prs.Save("with-shape.pptx", SaveFormat.Pptx);

ขั้นตอนที่ 6: บันทึกงานนำเสนอ

เรียก prs.Save(path, SaveFormat.Pptx) ก่อนที่อ็อบเจ็กต์จะถูกทำลาย. PPTX เป็นรูปแบบเอาต์พุตที่สนับสนุนเดียว.

prs.Save("result.pptx", SaveFormat.Pptx);

ไฟล์จะถูกเขียนแบบอะตอมิก; หากเกิดข้อผิดพลาดก่อนการเรียกนี้ จะไม่มีไฟล์ผลลัพธ์ถูกสร้างขึ้น.

ตัวอย่างทำงานครบถ้วน

โปรแกรมต่อไปนี้สร้างงานนำเสนอสองสไลด์โดยมีรูปทรงหัวเรื่องบนสไลด์แรกและตารางบนสไลด์ที่สอง.

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Drawing;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();

// --- Slide 1: title shape ---
var slide1 = prs.Slides[0];
var title = slide1.Shapes.AddAutoShape(ShapeType.Rectangle, 40, 40, 640, 80);
var tf = title.AddTextFrame("Q1 Results: Executive Summary");
var fmt = tf.Paragraphs[0].Portions[0].PortionFormat;
fmt.FontHeight = 32;
fmt.FontBold = NullableBool.True;
fmt.FillFormat.FillType = FillType.Solid;
fmt.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 0, 70, 127);

// --- Slide 2: table ---
prs.Slides.AddEmptySlide(prs.LayoutSlides[0]);
var slide2 = prs.Slides[1];
var table = slide2.Shapes.AddTable(40, 40,
    new double[] { 200.0, 120.0, 120.0 },
    new double[] { 40.0, 40.0, 40.0 });

string[] headers = { "Region", "Revenue", "Growth" };
string[][] data = {
    new[] { "North", "$1.2M", "+8%" },
    new[] { "South", "$0.9M", "+4%" },
};

for (int col = 0; col < headers.Length; col++)
    table.Rows[0][col].TextFrame.Text = headers[col];

for (int row = 0; row < data.Length; row++)
    for (int col = 0; col < data[row].Length; col++)
        table.Rows[row + 1][col].TextFrame.Text = data[row][col];

prs.Save("q1-results.pptx", SaveFormat.Pptx);
Console.WriteLine("Saved q1-results.pptx");

ปัญหาทั่วไปและวิธีแก้

ObjectDisposedException

คุณกำลังใช้ Presentation วัตถุหลังจาก using บล็อกได้สิ้นสุดแล้ว. งานทั้งหมดต้องทำก่อนที่วัตถุจะถูกทำลาย.

ข้อผิดพลาดเนมสเปซหายไปสำหรับ ShapeType

ตรวจสอบให้แน่ใจว่าคุณมี using Aspose.Slides.Foss; ที่ด้านบนของไฟล์ของคุณ. ShapeType, NullableBool, FillType, และ enum อื่น ๆ อยู่ในเนมสเปซนี้.

SaveFormat นอกจาก Pptx

การส่งค่าใด ๆ SaveFormat ค่าที่ไม่ใช่ SaveFormat.Pptx จะไม่ทำให้เกิดข้อยกเว้น พารามิเตอร์ format จะถูกละเลยโดยไม่มีการแจ้งเตือนและจะสร้าง PPTX เสมอ ควรใช้เสมอ SaveFormat.Pptx เพื่อให้ชัดเจน.

คำถามที่พบบ่อย

ขนาดสไลด์เริ่มต้นคืออะไร?

ใหม่ Presentation() สร้างสไลด์ที่ขนาดมาตรฐาน 10 x 7.5 นิ้ว (720 x 540 พอยต์) การเปลี่ยนขนาดสไลด์ยังไม่รองรับในรุ่นนี้.

ฉันสามารถเพิ่มสไลด์มากกว่าหนึ่งสไลด์ได้หรือไม่?

ใช่ เรียก prs.Slides.AddEmptySlide(prs.LayoutSlides[0]) เพื่อเพิ่มสไลด์เปล่าและเข้าถึงโดยดัชนี:

prs.Slides.AddEmptySlide(prs.LayoutSlides[0]);
var slide2 = prs.Slides[1];

ฉันสามารถเปิดไฟล์ที่มีอยู่แล้วและเพิ่มสไลด์ได้หรือไม่?

ได้:

using var prs = new Presentation("existing.pptx");
prs.Slides.AddEmptySlide(prs.LayoutSlides[0]);
prs.Save("existing.pptx", SaveFormat.Pptx);

ฉันสามารถบันทึกเป็นรูปแบบใดได้บ้าง?

เฉพาะ SaveFormat.Pptx ได้รับการสนับสนุน การส่งออกเป็น PDF, HTML, SVG หรือรูปภาพไม่พร้อมใช้งานในรุ่นนี้.