当前位置：首页 > news >正文

PDF处理控件Aspose.PDF教程：在C#中将PDF转换为Base64

news 2025/10/21 7:14:57

开发人员经常需要以基于文本的格式（例如JSON、XML或HTML属性）共享或存储PDF内容。Base64 编码也用于通过 API 传输文件或将其安全地保存在数据库中。Base64 编码也用于通过 API 传输文件或将其安全地保存在数据库中。它提供了一种可靠的方法，将二进制 PDF 数据表示为纯文本，同时保留每个字节以便稍后进行精确重建。在本教程中，您将学习如何借助Aspose.PDF使用C#将PDF转换为Base64编码，并将其解码回 PDF 文件。

Aspose.PDF官方试用版下载

Aspose.PDF for .NET — 一款强大的 C# PDF 转 Base64 转换器

在本文中，我们使用 Aspose.PDF for .NET，这是一个功能强大的 C# 库，用于创建、读取、编辑和转换 PDF 文件。它无需 Adobe Acrobat 或任何外部工具，即可完全控制 PDF 的内容和结构。使用 Aspose.PDF，您可以轻松加载现有 PDF 文档、进行修改、应用安全设置，并将其导出为各种格式，包括 Base64 编码的文本。

请从慧都网下载 Aspose.PDF for .NET。您也可以使用以下命令从NuGet安装它：

PM> Install-Package Aspose.PDF

在 C# 中将 PDF 转换为 Base64

当您需要在编码前处理 PDF 文件时，可以直接从内存中将其转换为 Base64 编码。此方法允许您使用该类打开 PDF Aspose.Pdf.Document，进行任何更改，然后将其保存到MemoryStream。最后，您可以将流转换为 Base64 字符串，以便轻松通过 API 传输或存储在数据库中。

按照以下步骤在 C# 中将 PDF 文件转换为 base64 字符串：

使用该类加载 PDF Document。
将文档保存为MemoryStream.
使用该方法将字节数组转换为Base64字符串Convert.ToBase64String()。
使用或返回 Base64 字符串。

以下代码示例显示如何将 PDF 转换为 Base64 字符串。

using Aspose.Pdf;
using Aspose.Pdf.Text;// 1) Load the PDF
using var doc = new Document("sample_pdf.pdf");// Optionally perform edits here, e.g., optimize, redact, secure, etc.// 2) Save to memory
using var ms = new MemoryStream();
doc.Save(ms);
var bytes = ms.ToArray();// 3) Convert to Base64
var base64 = Convert.ToBase64String(bytes);Console.WriteLine(base64.Substring(0, Math.Min(base64.Length, 120)) + "...");

使用 C# 将 PDF 的特定页面转换为 Base64

当您需要发送 PDF 文档的一小部分（例如单页或选定的几页）时，可以仅将部分内容转换为 Base64 编码。此方法有助于减少通过 API 或其他基于文本的渠道传输数据时的有效负载大小。

按照以下步骤将 PDF 的特定页面转换为 Base64 字符串：

使用该类加载 PDF 文件Document。
创建一个新的Document类对象来保存提取的页面。
将所需页面复制到新文档中。
保存MemoryStream并编码为 Base64。

using System;
using System.IO;
using Aspose.Pdf;// Open the source PDF from a file path
using var src = new Document("sample_pdf.pdf");// Create a new empty PDF that will contain only the selected page(s)
using var sub = new Document();// Copy the requested page into the new document
sub.Pages.Add(src.Pages[1]);// Save the one-page PDF to memory instead of disk
using var ms = new MemoryStream();
sub.Save(ms);// Convert the in-memory PDF bytes to a Base64 string
var base64 = Convert.ToBase64String(ms.ToArray());// Print a short preview of the Base64 text to the console
Console.WriteLine(base64.Substring(0, Math.Min(base64.Length, 120)) + "...");

创建新的 PDF 文档并转换为 Base64

您可以在内存中构建一个新的 PDF，并将其转换为 Base64 编码，而无需访问磁盘。当您动态生成文档并需要通过 API 发送、嵌入 JSON 或 HTML 格式，或将其存储在数据库中时，此功能非常有用。在此方法中，您需要创建一个Aspose.Pdf.Document，添加内容，将其保存到MemoryStream，然后将字节转换为 Base64 字符串。

按照以下步骤创建一个新的 PDF 文档并将其转换为 Base64：

创建一个空的Document。
添加页面并放置一些文本TextFragment。
将文档保存为MemoryStream.
将流字节转换为 Base64 字符串。

using System;
using System.IO;
using Aspose.Pdf;// 1) Create a new PDF document in memory
var pdf = new Document();// 2) Add a page and some sample content
var page = pdf.Pages.Add();
var header = new TextFragment("Hello from Aspose.PDF");
header.TextState.FontSize = 18;
header.TextState.FontStyle = FontStyles.Bold;
page.Paragraphs.Add(header);var body = new TextFragment("This PDF was generated in memory and then converted to Base64.");
body.TextState.FontSize = 12;
page.Paragraphs.Add(body);// 3) Save to a MemoryStream
using var ms = new MemoryStream();
pdf.Save(ms);
byte[] bytes = ms.ToArray();// 4) Convert to Base64 string
string base64 = Convert.ToBase64String(bytes);// 5) Optionally prepare a data URI for browsers or embed in JSON
string dataUri = $"data:application/pdf;base64,{base64}";// Output for demo purposes
Console.WriteLine("Base64 length: " + base64.Length);
Console.WriteLine("Data URI sample (truncated): " + dataUri.Substring(0, Math.Min(dataUri.Length, 80)) + "...");

在 C# 中将 Base64 转换为 PDF

当您的应用程序从客户端或 API 接收编码数据时，您可以将 Base64 字符串转换回 PDF 文件。当您需要恢复原始文档、将其保存到磁盘或将其加载到Aspose.Pdf.Document类中进行进一步处理（例如编辑、保护或提取内容）时，此功能非常有用。

按照以下步骤将 Base64 字符串转换为 PDF 文档：

加载编码的字符串（例如，从文件或 API）。
将字符串转换为原始 PDF 字节。
Document使用带有解码字节的类对象创建 PDF 文档。
保存 PDF 文档。

以下代码示例显示如何使用 C# 将 Base64 字符串转换回 PDF 文档：

using System;
using System.IO;
using Aspose.Pdf;// Read Base64 text from a file and trim extra whitespace or newlines
using System;
using System.IO;
using Aspose.Pdf;// Read the text file
string base64 = File.ReadAllText("sample-base64.txt").Trim();// Optional: handle data URI input like "data:application/pdf;base64,AAAA..."
// Detect and strip the prefix so only the raw Base64 remains
const string prefix = "data:application/pdf;base64,";
if (base64.StartsWith(prefix, StringComparison.OrdinalIgnoreCase))base64 = base64.Substring(prefix.Length);// Decode the Base64 string into a byte array
byte[] pdfBytes = Convert.FromBase64String(base64);// Validate by loading the bytes into Aspose.PDF; this throws if bytes are not a valid PDF
using var doc = new Document(new MemoryStream(pdfBytes));// Persist the recovered PDF to disk
doc.Save("output.pdf");