使用IRONPDF

如何在 C# 中將 PDF 轉換為字節數組

發表日期:11月 10, 2025

將PDF類型的文件轉換為字節數組是一項現代.NET應用程式中的基本需求。無論您是需要將PDF存儲在數據庫中，通過API傳輸文件，還是在內存中處理文件內容，理解字節數組轉換都是必不可少的。 IronPDF通過其直觀的API簡化了這個過程，使開發人員能夠有效地轉換文件，無需複雜的代碼。

什麼是字節數組以及為什麼要轉換PDF文件？

字節數組是一種將二進制數據作為字節序列存儲的數據結構。在處理PDF文檔時，轉換為字節數組提供了若干優勢。此格式使得在數據庫BLOB字段中的高效存儲、通過Web服務的無縫傳輸，以及內存中的簡化文件內容操作變得可能。

開發人員在構建文檔管理系統、實施用戶上傳文件的雲存儲解決方案或創建處理PDF數據的API時經常將PDF文件轉換為字節數組。二進制數據格式確保文檔內容在傳輸和存儲過程中保持完整，保留所有頁面、格式和嵌入資源。這個過程類似於您可能處理其他文件類型，如PNG圖像或DOC文件。

如何在C#中將PDF轉換為字節數組？

IronPDF提供了兩種簡單的方法來將PDF文檔轉換為字節數組。 BinaryData屬性提供了對PDF字節表示的直接訪問，而Stream屬性則返回一個新的MemoryStream以獲得額外的靈活性。

using IronPdf;

// Create a new PDF document from HTML
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Sample Document</h1><p>This is test content.</p>");

// Method 1: Direct conversion to byte array
byte[] pdfBytes = pdf.BinaryData;

// Method 2: Using MemoryStream
using (var memoryStream = pdf.Stream)
{
    byte[] pdfBytesFromStream = memoryStream.ToArray();
}

// Save byte array length for verification
System.Console.WriteLine($"PDF size: {pdfBytes.Length} bytes");

using IronPdf;

// Create a new PDF document from HTML
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Sample Document</h1><p>This is test content.</p>");

// Method 1: Direct conversion to byte array
byte[] pdfBytes = pdf.BinaryData;

// Method 2: Using MemoryStream
using (var memoryStream = pdf.Stream)
{
    byte[] pdfBytesFromStream = memoryStream.ToArray();
}

// Save byte array length for verification
System.Console.WriteLine($"PDF size: {pdfBytes.Length} bytes");

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

上面的代碼演示了這兩種轉換方法。 BinaryData屬性提供了最直接的方法，即時返回字節數組表示。對於需要流操作的場景，Stream屬性提供了一個MemoryStream實例，您可以使用ToArray()方法將其轉換為字節。

控制台輸出

如何在C#中將PDF轉換為字節數組：圖1 - 控制台輸出和PDF字節數組大小

如何將現有PDF文檔轉換為字節數組？

在電腦上處理現有PDF文檔時，IronPDF使得讀取文件內容並將其轉換為字節數組變得簡單。

using IronPdf;
using System.IO;

// Load an existing PDF document
var existingPdf = PdfDocument.FromFile("report.pdf");

// Convert to byte array
byte[] fileBytes = existingPdf.BinaryData;

// Alternative: Using System.IO for direct file reading
byte[] directBytes = File.ReadAllBytes("report.pdf");

// Create PdfDocument from byte array
var loadedPdf = new PdfDocument(directBytes);

// Verify pages were loaded correctly
int pageCount = loadedPdf.PageCount;
System.Console.WriteLine($"Loaded PDF with {pageCount} pages");

using IronPdf;
using System.IO;

// Load an existing PDF document
var existingPdf = PdfDocument.FromFile("report.pdf");

// Convert to byte array
byte[] fileBytes = existingPdf.BinaryData;

// Alternative: Using System.IO for direct file reading
byte[] directBytes = File.ReadAllBytes("report.pdf");

// Create PdfDocument from byte array
var loadedPdf = new PdfDocument(directBytes);

// Verify pages were loaded correctly
int pageCount = loadedPdf.PageCount;
System.Console.WriteLine($"Loaded PDF with {pageCount} pages");

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

上面的代碼顯示了處理現有文件的兩種方法。 IronPDF的FromFile方法加載文檔並提供對BinaryData屬性的訪問。或者，您可以直接使用System.IO.File.ReadAllBytes()讀取字節，然後從這些字節創建一個PdfDocument實例。

如何在C#中將PDF轉換為字節數組：圖2 - 控制台輸出和顯示的頁面計數

如何將字節數組轉換回PDF？

將字節數組轉換回PDF文檔同樣簡單。此功能在從數據庫檢索PDF數據或通過API接收文件時至關重要。

using IronPdf;

// Example byte array (typically from database or API)
byte[] pdfBytes = GetPdfBytesFromDatabase();

// Create PdfDocument from byte array
var pdfDocument = new PdfDocument(pdfBytes);

// Save the modified PDF
pdfDocument.SaveAs("modified-document.pdf");

// Or get updated bytes for storage
byte[] updatedBytes = pdfDocument.BinaryData;

// Mock method to simulate fetching PDF bytes from a database
byte[] GetPdfBytesFromDatabase()
{
    // Simulate fetching PDF bytes
    return File.ReadAllBytes("example.pdf");
}

using IronPdf;

// Example byte array (typically from database or API)
byte[] pdfBytes = GetPdfBytesFromDatabase();

// Create PdfDocument from byte array
var pdfDocument = new PdfDocument(pdfBytes);

// Save the modified PDF
pdfDocument.SaveAs("modified-document.pdf");

// Or get updated bytes for storage
byte[] updatedBytes = pdfDocument.BinaryData;

// Mock method to simulate fetching PDF bytes from a database
byte[] GetPdfBytesFromDatabase()
{
    // Simulate fetching PDF bytes
    return File.ReadAllBytes("example.pdf");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

PdfDocument構造函數直接接受字節數組，從而實現從二進制數據到可用PDF的無縫轉換。

如何在C#中將PDF轉換為字節數組：圖3 - 流程圖顯示數據庫 → 字節數組 → PdfDocument → 修改的PDF過程

如何處理內存流和文件內容？

內存流提供了一種有效的方式來處理PDF內容而無需創建臨時文件。這種方法在需要動態生成和提供PDF的Web應用程式中特別有用。

using IronPdf;
using System.IO;

var renderer = new ChromePdfRenderer();

// Generate PDF in memory
using (var newMemoryStream = new MemoryStream())
{
    // Create PDF and save to stream
    var pdf = renderer.RenderHtmlAsPdf("<h1>Invoice</h1><p>Total: $100</p>");
    pdf.SaveAs(newMemoryStream);

    // Convert stream to byte array
    byte[] pdfData = newMemoryStream.ToArray();

    // Use bytes for web response, email attachment, or storage
    SaveToDatabase(pdfData);
}

// Load PDF from byte array into new MemoryStream
byte[] storedBytes = GetFromDatabase();
using (var newMemoryStream = new MemoryStream(storedBytes))
{
    var restoredPdf = new PdfDocument(newMemoryStream);
    // Work with restored document
}

using IronPdf;
using System.IO;

var renderer = new ChromePdfRenderer();

// Generate PDF in memory
using (var newMemoryStream = new MemoryStream())
{
    // Create PDF and save to stream
    var pdf = renderer.RenderHtmlAsPdf("<h1>Invoice</h1><p>Total: $100</p>");
    pdf.SaveAs(newMemoryStream);

    // Convert stream to byte array
    byte[] pdfData = newMemoryStream.ToArray();

    // Use bytes for web response, email attachment, or storage
    SaveToDatabase(pdfData);
}

// Load PDF from byte array into new MemoryStream
byte[] storedBytes = GetFromDatabase();
using (var newMemoryStream = new MemoryStream(storedBytes))
{
    var restoredPdf = new PdfDocument(newMemoryStream);
    // Work with restored document
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

此示例演示了使用內存流創建、保存和加載PDF的完整工作流程。

Web應用程式的最佳實踐是什麼？

在Web應用程式中提供PDF時，正確處理字節數組可確保最佳性能。以下是在ASP.NET中向用戶發送PDF字節的方法：

// In an MVC Controller
public FileResult DownloadPdf()
{
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf("<h1>Report</h1>");
    byte[] pdfBytes = pdf.BinaryData;
    return File(pdfBytes, "application/pdf", "report.pdf");
}

// In an MVC Controller
public FileResult DownloadPdf()
{
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf("<h1>Report</h1>");
    byte[] pdfBytes = pdf.BinaryData;
    return File(pdfBytes, "application/pdf", "report.pdf");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

為了高效的存儲和檢索，請考慮以下做法：完成後處理PdfDocument對象的大規模文件流來避免內存問題，並為文件操作實施正確的錯誤處理。

結論

IronPDF簡化PDF到字節數組C#轉換，為開發人員提供強大而簡單的方法來將PDF文件處理為二進制數據。無論您是在構建API，管理文檔數據庫，還是創建Web應用程式，IronPDF的BinaryData和Stream屬性都提供了現代PDF處理所需的靈活性。我們希望本文能夠幫助您理解如何將PDF文件轉換、保存和操作為字節數組。