面向 .NET 的 C# NuGet 无需原生 DLL

适用于 .NET 的 C# PDF 库:创建、查看和签名 PDF 文件

sgcPDF 是一个完全托管代码的 C# PDF 库:用 C# 创建 PDF 文件,在 WinForms、WPF 和 Avalonia 查看器中显示并签名,无需部署原生 DLL。

在 C# 中创建 PDF 和 HTML 转 PDF WinForms、WPF 和 Avalonia 查看器 PAdES 签名、PDF/A 和 PDF/UA 在 Windows、Linux 和 macOS 上 PDF 转 PNG

查看价格 →   .NET 下载和演示 →

sgcPDF 将带 CSS 的 HTML 页面转换为 PDF:左侧是 HTML 源代码,右侧是渲染出的季度订单汇总,包含标题、订单表格、合计和项目符号列表

sgcPDF 生成和显示的内容

通过代码生成的文档、渲染为图像的页面、表单、涂黑和条形码,全部来自同一个托管的 .NET PDF 库。

如何在 C# 中创建 PDF

作为用于发票、报表和票据的 C# PDF 生成器,sgcPDF 只需四步:创建 TsgcPDFDocument,用 AddPage 添加页面,在其上绘制内容,然后调用 SaveToFile。坐标以 PDF 点(1/72 英寸)为单位,原点位于页面左下角。所有类型都在 esegece.sgcPDF 命名空间中。

Program.cs
using System;
using esegece.sgcPDF;

class Program
{
    static void Main()
    {
        using (TsgcPDFDocument oDoc = new TsgcPDFDocument())
        {
            oDoc.Info.Title = "Invoice 2026-001";
            // A4 portrait: 595 x 842 points, origin at the bottom left corner
            TsgcPDFPage oPage = oDoc.AddPage(595, 842);
            oPage.DrawText("Invoice 2026-001", 50, 780, TsgcPDFStandardFont.sfHelveticaBold, 24);
            oPage.DrawLine(50, 770, 545, 770, 1.0);
            oPage.DrawText("Created in C# with sgcPDF.", 50, 740, TsgcPDFStandardFont.sfHelvetica, 12);
            oDoc.SaveToFile("invoice.pdf");
        }
    }
}

内容

使用 14 种标准 PDF 字体或嵌入并子集化的 TrueType 和 OpenType 字体的文本,Unicode 和从右到左的文本,图像(JPEG、带 Alpha 的 PNG、BMP、TIFF),线条、曲线、渐变和透明度,可跨页延续的表格,批注、书签和图层。

编辑现有文件

TsgcPDFEditor 可添加水印、页眉、页脚和页码,插入空白页,以及提取、删除、旋转和移动页面。使用 sgcPDF_Editor.sgcPDFMergeFiles 合并文件。增量保存会追加一个修订版本,并保持先前的签名有效。

提取

ExtractTextW 返回页面的文本,TsgcPDFTextExtractor 提供带位置的文本片段,TsgcPDFImageExtractor 可列出并保存 PDF 中的图像。

在 C# 中将 HTML 转为 PDF

TsgcPDFHTMLRenderer 可将带 CSS 的 HTML 转换为分页的 PDF:标题、段落、行内样式、列表、表格、图像、链接、分页符、页眉、页脚和页码。

using (TsgcPDFHTMLRenderer oHTML = new TsgcPDFHTMLRenderer())
{
    oHTML.PageWidth = 595;
    oHTML.PageHeight = 842;
    oHTML.FooterText = "Page {page} of {pages}";
    oHTML.HTMLToPDFFile(
        "<html><head><style>h1 { color: #003366 }</style></head><body>" +
        "<h1>Invoice 2026-001</h1>" +
        "<table><tr><th>Item</th><th>Amount</th></tr>" +
        "<tr><td>Consulting</td><td>299.00</td></tr></table>" +
        "</body></html>", "invoice-html.pdf");
}

// merge the two files into one
sgcPDF_Editor.sgcPDFMergeFiles(new string[] { "invoice.pdf", "invoice-html.pdf" }, "merged.pdf");

在 C# 中生成条形码和二维码

Code 128、Code 39、EAN-13、EAN-8、UPC-A、ITF、Codabar、GS1-128、QR Code、DataMatrix (ECC200) 和 PDF417 以矢量方式绘制在 PDF 页面上。TsgcPDFBarcodeControl(WinForms)、TsgcWpfPDFBarcodeControl 和 TsgcAvaloniaPDFBarcodeControl 可在屏幕上显示它们,并保存为 PNG 或 SVG。

// Code 128 barcode in a 250 x 60 point box, black on white
TsgcPDFBarcodeSymbol oSymbol = new TsgcPDFBarcodeSymbol();
oSymbol.Symbology = TsgcPDFBarcodeType.bcCode128;
oSymbol.Text = "TKT-2026-001";
oSymbol.DrawToPDF(oPage, 50, 680, 250, 60, 0x000000, 0xFFFFFF);

// QR Code in a 120 x 120 point box
oSymbol.Symbology = TsgcPDFBarcodeType.bcQRCode;
oSymbol.QRErrorLevel = TsgcPDFQRErrorLevel.qrecQ;
oSymbol.Text = "https://www.esegece.com";
oSymbol.DrawToPDF(oPage, 50, 540, 120, 120, 0x000000, 0xFFFFFF);

适用于 WinForms、WPF 和 Avalonia 的 C# PDF 查看器

三个原生查看器控件,每个都带有缩略图视图和大纲(书签)视图。页面由 sgcPDF 的 C# 渲染器绘制,因此无需随应用程序附带原生 PDF 引擎。

WinForms PDF 查看器

esegece.sgcPDF.WinForms 中的 TsgcPDFViewerControl、TsgcPDFThumbnailView 和 TsgcPDFOutlineView,适用于 Windows 上的 .NET Framework 4.7.2 和 .NET 8。支持交互式批注和评论回复、表单填写、页面框和测量工具。

WPF PDF 查看器

esegece.sgcPDF.Wpf 中的 TsgcWpfPDFViewer、TsgcWpfPDFThumbnailView 和 TsgcWpfPDFOutlineView,适用于 Windows 上的 .NET Framework 4.7.2 以及 .NET 8、9 和 10。提供可绑定的依赖属性,页面在后台线程上渲染,因此处理大文件时 UI 仍保持响应。

Avalonia PDF 查看器

esegece.sgcPDF.Avalonia 中的 TsgcAvaloniaPDFViewer、TsgcAvaloniaPDFThumbnailView 和 TsgcAvaloniaPDFOutlineView,适用于 Windows、Linux 和 macOS 上的 .NET 8、9 和 10,具有 WPF 查看器的功能,并增加了双指缩放。

三个查看器都提供连续、单页和双页布局,适合宽度、适合页面和自定义缩放,框选缩放,文本选择和复制,带高亮匹配项的搜索,链接,使用便笺、高亮、形状、墨迹和图章的批注编辑,以及表单填写。完整的功能列表请参阅 PDF 查看器页面。

MainForm.cs
using System.Windows.Forms;
using esegece.sgcPDF;

public class MainForm : Form
{
    TsgcPDFThumbnailView FThumbnails;
    TsgcPDFViewerControl FViewer;

    public MainForm()
    {
        Width = 1100;
        Height = 800;
        // page thumbnails on the left
        FThumbnails = new TsgcPDFThumbnailView();
        FThumbnails.Parent = this;
        FThumbnails.Dock = DockStyle.Left;
        FThumbnails.Width = 160;
        // the viewer fills the rest of the form
        FViewer = new TsgcPDFViewerControl();
        FViewer.Parent = this;
        FViewer.Dock = DockStyle.Fill;
        FViewer.BringToFront();
        FViewer.ZoomMode = TsgcPDFViewerZoomMode.zmFitWidth;
        FThumbnails.Viewer = FViewer;
        FViewer.LoadFromFile("invoice.pdf");
    }
}
ViewerWindow.xaml
<Window x:Class="MyApp.ViewerWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:sgc="https://www.esegece.com/sgcui"
        Title="PDF Viewer" Width="1100" Height="800">
  <DockPanel>
    <sgc:TsgcWpfPDFThumbnailView DockPanel.Dock="Left" Width="160"
                                 Viewer="{Binding ElementName=Viewer}" ThumbnailWidth="120" />
    <sgc:TsgcWpfPDFViewer x:Name="Viewer" Source="invoice.pdf"
                          ZoomMode="zmFitWidth" ViewMode="pvmContinuous" />
  </DockPanel>
</Window>

在代码隐藏文件中,Viewer.LoadFromFile、Viewer.FindText 和 Viewer.PrintDialog 可打开、搜索和打印文档。所有 sgcUI 产品都使用 XAML 命名空间 https://www.esegece.com/sgcui。

在 C# 中将 PDF 页面转换为图像

TsgcPDFRendererRaster 以托管代码将页面渲染为 PNG 或 BMP。它可在 .NET 运行的每个平台上工作,因此 Linux 服务器上的 Web API 或后台服务可以创建缩略图和预览。在 Windows 上,WinForms 包增加了 GDI 渲染器和页面导出为图像的功能。

using (TsgcPDFDocument oDoc = new TsgcPDFDocument())
{
    oDoc.LoadFromFile("invoice.pdf");
    TsgcPDFPage oPage = oDoc.GetPage(0);
    // 144 DPI: a PDF point is 1/72 inch
    int vWidth = (int)Math.Round(oPage.Width * 144 / 72);
    int vHeight = (int)Math.Round(oPage.Height * 144 / 72);
    TsgcPDFRendererRaster oRenderer = new TsgcPDFRendererRaster();
    oRenderer.RenderPageToPNG(oDoc.Parser, oPage.PageDict, vWidth, vHeight, "page1.png");
}

在 C# 中为 PDF 签名

TsgcPDFSignatureHandler 使用 PFX 证书和可见签名字段为 PDF 签名,TsgcPDFSignatureVerifier 则检查文件的签名。在 .NET 中,签名使用 System.Security.Cryptography。使用 Windows 证书存储进行签名需要 Windows。

using (TsgcPDFSignatureHandler oSigner = new TsgcPDFSignatureHandler())
{
    oSigner.LoadCertificateFromPFX("signer.pfx", "password");
    oSigner.Reason = "Contract approval";
    oSigner.Location = "Barcelona";
    // visible signature field on page 1: name, page, left, bottom, right, top
    oSigner.SetField("Signature1", 0, 50, 50, 300, 120);
    oSigner.SignDocument("contract.pdf", "contract-signed.pdf");
}

PAdES B-B 到 B-LTA

可选的 esegece.sgcPDF.sgcSign 包增加了 TsgcPDFPAdESSigner,可使用 sgcSign .NET(需单独授权)的任意密钥提供程序,签出 PAdES B-B、B-T、B-LT 和 B-LTA。

手写签名

TsgcPDFSignaturePad(WinForms)、能从触控笔读取笔压的 TsgcWpfPDFSignaturePad,以及 TsgcAvaloniaPDFSignaturePad,可通过鼠标、手指或笔记录签名。

PDF/A、PDF/UA、加密和涂黑

esegece.sgcPDF 包涵盖存档、无障碍和安全,每项都有已编译的 .NET 演示。

PDF/A

PDF/A-1b、PDF/A-2b 和 PDF/A-3b 输出(带嵌入的 TrueType 字体)、PDF/A-4,以及用于检查文件的 TsgcPDFAValidator。带有 PDF/A-3 关系的嵌入文件可承载 Factur-X 电子发票。

PDF/UA 和带标签的 PDF

带结构树和图形替代文字的带标签 PDF、PDF/UA-1 输出(也可作为 PDF/A-2a)以及 PDF/UA-2,使屏幕阅读器能够顺序阅读文档。

加密

使用 RC4-128、AES-128 或 AES-256 和权限进行密码保护,或为一个或多个接收者证书加密。

涂黑

TsgcPDFRedactor 会从内容中删除文本和区域,因此被涂黑的数据已从文件中消失,而不是隐藏在一个框下面。

表单

创建带文本字段、组合框、复选框和按钮的 AcroForm,通过代码填写,并导出和导入其数据。

印前

页面框、带裁切标记的拼版、专色、叠印预览和 PDF/X 输出意图。请参阅印前功能。

从 NuGet 安装 C# PDF 库

只有 esegece.sgcPDF 是必需的。为你的 UI 框架的查看器控件添加 WinForms、WPF 或 Avalonia 包,为 PAdES 签名添加 sgcSign 包。在 Visual Studio 中,使用“管理 NuGet 程序包”并搜索 esegece.sgcPDF。

dotnet add package esegece.sgcPDF
dotnet add package esegece.sgcPDF.WinForms
dotnet add package esegece.sgcPDF.Wpf
dotnet add package esegece.sgcPDF.Avalonia
dotnet add package esegece.sgcPDF.sgcSign

对于免费的 Community 版本,请使用相同的包 ID 并加上 .Community 后缀,例如 dotnet add package esegece.sgcPDF.Community。一个项目中只引用两个版本之一。请参阅.NET 安装指南和 .NET API 差异。

.NET 版本和平台

核心包可在 .NET 运行的任何地方运行,包括 Windows、Linux 和 macOS。netstandard2.0 目标还可用于 .NET Framework 4.6.2 及更高版本和 Mono。唯一的第三方依赖是 System.Security.Cryptography.Pkcs,以及在 netstandard2.0 和 net472 上的 System.Memory。

包目标框架操作系统
esegece.sgcPDFnetstandard2.0、net472、net6.0、net8.0、net9.0、net10.0Windows、Linux、macOS
esegece.sgcPDF.WinFormsnet472、net8.0-windowsWindows
esegece.sgcPDF.Wpfnet472, net8.0-windows, net9.0-windows, net10.0-windowsWindows
esegece.sgcPDF.Avalonianet8.0、net9.0、net10.0,需要 Avalonia 12.0.0 或更高版本Windows、Linux、macOS
esegece.sgcPDF.sgcSignnetstandard2.0、net472、net6.0、net8.0、net9.0、net10.0依赖 esegece.sgcSign

.NET 演示包括 26 个 Windows Forms 演示,涵盖创建、条形码、表单、加密、签名、PDF/A、带标签的 PDF、文本提取和查看器,另有查看器、签名板、图像编辑器和条形码控件的 WPF 和 Avalonia 演示。了解 .NET 演示。

Community 和 Registered 版本

两个版本的功能相同。它们的区别在于许可,而不是能力。

Community,免费

.Community 包对年总收入低于 100 万欧元且开发者不超过 5 人的个人和组织免费,可用于商业和非商业用途。它们会显示简短的启动提示。达到或超过任一门槛的组织需要 Registered 许可证。

NuGet 上的 esegece.sgcPDF.Community →

Registered

去除启动提示,并附带商业许可证。提供 Single、Team 和 Site 许可证,均含完整源代码、1 年更新以及 50% 到 70% 的续订折扣。

sgcPDF .NET 价格 →

sgcPDF .NET

€249

提供 Single、Team 和 Site 许可证。

  • NuGet:esegece.sgcPDF 以及 WinForms、WPF、Avalonia 和 sgcSign 包
  • .NET Standard 2.0、.NET Framework 4.7.2、.NET 6、.NET 8、.NET 9、.NET 10
  • 完整源代码
  • 1 年更新

C# PDF 常见问题

添加 esegece.sgcPDF NuGet 包(或 esegece.sgcPDF.Community),创建 TsgcPDFDocument,用 AddPage 添加页面,在其上绘制文本、线条、图像、表格和条形码,然后调用 SaveToFile,如创建 PDF 示例所示。若要转换带 CSS 的 HTML,请调用 TsgcPDFHTMLRenderer 的 HTMLToPDFFile。

最佳选择是能涵盖你的应用程序所需功能的库。sgcPDF 在一个托管 .NET 库中涵盖了完整的 PDF 生命周期:创建、编辑、合并、提取,在 WinForms、WPF 和 Avalonia 中查看,渲染为图像,加密、签名、涂黑和验证 PDF/A,无需原生 DLL,每种许可证都包含完整的 C# 源代码。免费的 Community 包功能相同,因此你可以在决定之前用自己的文档测试 sgcPDF。

可以。esegece.sgcPDF.Wpf 包中的 TsgcWpfPDFViewer 是一个 WPF 控件,其页面由托管的 sgcPDF 渲染器在后台线程上渲染。无需部署任何原生组件。它可在 Windows 上的 .NET Framework 4.7.2 以及 .NET 8、9 和 10 上运行。WinForms 请使用 TsgcPDFViewerControl,Windows、Linux 和 macOS 上的 Avalonia 请使用 TsgcAvaloniaPDFViewer。

将文件加载到 TsgcPDFDocument 中,并以页码和像素大小调用 TsgcPDFRendererRaster 的 RenderPageToPNG,如 PDF 转图像示例所示。光栅渲染器可写出 PNG 或 BMP,在 Windows、Linux 和 macOS 上都能工作,因此也可在服务器上运行。

可以。TsgcPDFSignatureHandler 使用 PFX 证书和可见签名字段签名,TsgcPDFSignatureVerifier 验证签名。对于 PAdES B-B、B-T、B-LT 和 B-LTA,请添加 esegece.sgcPDF.sgcSign:TsgcPDFPAdESSigner 可配合 sgcSign .NET(需单独授权)的任意密钥提供程序使用。

有。每个 sgcPDF NuGet 包也提供带 .Community 后缀的免费 Community 版本,功能相同。它对年总收入低于 100 万欧元且开发者不超过 5 人的个人和组织免费,并会显示简短的启动提示。规模更大的组织需要 Registered 许可证,请参阅 sgcPDF 价格。

该库面向 .NET Standard 2.0、.NET Framework 4.7.2、.NET 6、.NET 8、.NET 9 和 .NET 10。WinForms 查看器面向 Windows 上的 .NET Framework 4.7.2 和 .NET 8,WPF 查看器面向 Windows 上的 .NET Framework 4.7.2、.NET 8、.NET 9 和 .NET 10,Avalonia 查看器面向 .NET 8、.NET 9 和 .NET 10。

能。esegece.sgcPDF 包可在 .NET 运行的任何地方运行,包括 Linux 和 macOS,Avalonia 查看器可在 Windows、Linux 和 macOS 上运行。WinForms 和 WPF 包适用于 Windows。在 Windows 之外,请使用 AddTrueTypeFontFromFile 从文件加载 TrueType 字体。

超值之选:All-AccesseSeGeCe 全部产品,含高级支持,每年 €1,059 起。
查看 All-Access 价格

为你的 .NET 应用程序添加 PDF 功能

使用一个托管库,无需原生 DLL,即可在 C# 中创建、查看、签名和归档 PDF 文件。