Hướng Dẫn Sử Dụng PDFSharp

PDFSharp là một thư viện mạnh mẽ và miễn phí dùng để tạo, chỉnh sửa và xử lý các tệp PDF trong các dự án .NET. Bài viết này sẽ hướng dẫn bạn cách cài đặt và sử dụng cơ bản thư viện này.

Cài đặt

Các bước để tạo 1 file pdf đơn giản:

dotnet add package PdfSharp

1. Tạo file PDF cơ bản: Tạo đối tượng PdfDocument()

var document = new PdfDocument();

2. Thêm 1 page mới, chọn page size

var page = document.AddPage();
page.Size = PdfSharp.PageSize.A4;

3. Tạo đối tượng đồ họa để draw

var gfx = XGraphics.FromPdfPage(page);

4. Thiết lập font chữ

XFont font = new XFont("Arial", 16, XFontStyleEx.Bold);

5. Vẽ văn bản lên trang PDF

6. Lưu tài liệu PD

Dưới đây là ví dụ hoàn chỉnh

using PdfSharp.Drawing;
using PdfSharp.Pdf;

Console.WriteLine("Hello, World!");

var document = new PdfDocument();
document.Info.Title = "Demo PDFSharp";

var page = document.AddPage();
page.Size = PdfSharp.PageSize.A4;

var gfx = XGraphics.FromPdfPage(page);
XFont font = new XFont("Arial", 16, XFontStyleEx.Bold);
gfx.DrawString("Xin chào PDFSharp!", font, XBrushes.Black, new XPoint(100, 100));
var width = page.Width;
var height = page.Height;
gfx.DrawLine(XPens.Red, 0, 0, width, height);
gfx.DrawLine(XPens.Red, width, 0, 0, height);

var fileName = "DemoPDFSharp.pdf";
document.Save(fileName);
Console.WriteLine($"File was saved: {fileName}");

MigraDoc

MigraDoc là một công cụ tạo tài liệu. Thư viện hỗ trợ hầu hết mọi thứ trong bất kỳ trình soạn thảo văn bản: paragraph, table, chart, section, bookark, table of content, v.v. MigraDoc sẽ thực hiện bố cục page break khi cần. MigraDoc hỗ trợ tạo tài liệu PDF hoặc RTF.

Vậy tại sao không sử dụng PDFSharp?

Sử dụng PDFsharp nếu bạn muốn tạo tệp PDF duy nhất, nhưng có thể kiểm soát từng pixel và từng dòng được vẽ. Sử dụng MigraDoc nếu bạn cần tài liệu dưới dạng file PDF và RTF, hỗ trợ các hàm xử lý văn bản.

Giả sử ta có đoạn code sau:

Document document = new Document();
Section section = document.AddSection();

Paragraph paragraph = section.AddParagraph();
paragraph.AddText("This is the first paragraph");

Paragraph anotherParagraph = section.AddParagraph();
anotherParagraph.AddText("This is the second paragraph");

Section trong MigraDoc đại diện cho một phần (section) trong tài liệu. Mỗi Section có thể có cài đặt riêng như: pageSize, margin, heading, header/footer.

Một tài liệu có thể chứa nhiều Section, và mỗi Section có thể bắt đầu trên một trang mới.

Hai cách để tạo trang mới

Sử dụng Page break

Paragraph paragraph = section.AddParagraph();
paragraph.AddText("This is the first paragraph");

section.AddPageBreak();

Paragraph newParagraph = section.AddParagraph();
newParagraph.AddText("This is the second paragraph");

Tạo mới section

Sử dụng document.AddSection()

// Section 1
Section section1 = document.AddSection();
Paragraph paragraph1 = section1.AddParagraph();
paragraph1.AddText("This is the first paragraph");

// Section 2
Section section2 = document.AddSection(); 
Paragraph paragraph2 = section2.AddParagraph();
paragraph2.AddText("This is the second paragraph");

Khi nào nên dùng AddPageBreak hoặc AddSection?

Dùng AddPageBreak: Nếu bạn chỉ muốn thêm một trang mới trong cùng Section.
Dùng AddSection: Nếu bạn muốn thiết lập khổ giấy, lề, header/footer khác biệt cho mỗi phần.