Cách bắt đầu với Aspose.Slides FOSS cho .NET

Aspose.Slides.Foss cho .NET là một thư viện miễn phí, có giấy phép MIT, dùng để tạo và chỉnh sửa các tệp PowerPoint .pptx — không cần Microsoft Office, có sẵn trên NuGet.

Hướng Dẫn Từng Bước

Bước 1: Cài đặt gói

Cài đặt từ NuGet (yêu cầu .NET 9.0 trở lên):

dotnet add package Aspose.Slides.Foss

Xác minh việc cài đặt bằng cách xây dựng dự án:

dotnet build

Bước 2: Nhập các không gian tên cần thiết

Thêm các chỉ thị using cần thiết để tải bản trình chiếu và lưu:

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

Bước 3: Tạo bản trình chiếu

Tạo một Presentation không có đối số để bắt đầu với một slide trống. Luôn sử dụng using để đảm bảo các tài nguyên nội bộ được giải phóng:

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

using var prs = new Presentation();
Console.WriteLine($"Slides: {prs.Slides.Count}");
prs.Save("new_presentation.pptx", SaveFormat.Pptx);

Bước 4: Thêm một Hình dạng có Văn bản

Sử dụng slide.Shapes.AddAutoShape() để chèn một hình chữ nhật, sau đó gọi AddTextFrame() để thêm nội dung văn bản:

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

using var prs = new Presentation();
var slide = prs.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 400, 150);
var tf = shape.AddTextFrame("Hello from Aspose.Slides FOSS!");
var fmt = tf.Paragraphs[0].Portions[0].PortionFormat;
fmt.FontHeight = 24;
fmt.FontBold = NullableBool.True;
prs.Save("with_shape.pptx", SaveFormat.Pptx);

Bước 5: Áp dụng màu tô và Lưu

Đặt màu tô đặc cho hình trước khi lưu:

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

using var prs = new Presentation();
var shape = prs.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 400, 200);
shape.FillFormat.FillType = FillType.Solid;
shape.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 70, 130, 180);
shape.AddTextFrame("Styled shape");
prs.Save("styled.pptx", SaveFormat.Pptx);

Các vấn đề thường gặp và cách khắc phục

TypeLoadException hoặc DllNotFoundException
Đảm bảo bạn đang nhắm mục tiêu .NET 9.0 hoặc cao hơn. Thư viện yêu cầu .NET 9.0+. Cập nhật tệp
.csproj của bạn: <TargetFramework>net9.0</TargetFramework>

UnsupportedOperationException khi gọi một số phương thức
Một số tính năng (biểu đồ, hoạt ảnh, xuất PDF) không được hỗ trợ trong phiên bản này.
Kiểm tra tài liệu tham chiếu API để biết danh sách các hạn chế trước khi sử dụng các tính năng nâng cao.

ObjectDisposedException sau khối using
Không sử dụng một thể hiện Presentation bên ngoài khối using của nó. Truy cập tất cả các slide,
hình dạng và khung văn bản trước khi khối using kết thúc.

File not saved correctly
Luôn truyền một giá trị enum SaveFormat cho Save(). Phiên bản overload Save(path, SaveFormat.Pptx) ghi một tệp định dạng PPTX.

Câu hỏi thường gặp

Aspose.Slides.Foss có yêu cầu Microsoft Office không?

Không. Thư viện tạo và đọc các tệp .pptx một cách nguyên bản trong C# thuần túy mà không phụ thuộc vào Microsoft Office, tự động hoá COM, hoặc các API của Windows.

Các phiên bản .NET nào được hỗ trợ?

.NET 9.0 hoặc sau này. Thư viện chạy trên Windows, macOS, Linux và các container Docker.

Thư viện có miễn phí cho việc sử dụng thương mại không?

Có. Nó được phát hành dưới giấy phép MIT. Bạn có thể sử dụng, sửa đổi và phân phối lại nó cho bất kỳ mục đích nào, bao gồm các ứng dụng thương mại.

Tôi có thể tải một tệp PPTX hiện có không?

Có. Truyền đường dẫn tệp vào hàm tạo Presentation:

using var prs = new Presentation("existing.pptx");
Console.WriteLine($"Loaded {prs.Slides.Count} slides");
prs.Save("copy.pptx", SaveFormat.Pptx);

Tôi có cần gọi Dispose một cách rõ ràng không?

Có, thông qua câu lệnh using. Presentation thực hiện IDisposable và phải được giải phóng để giải phóng các tay cầm tệp và tài nguyên nội bộ.