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

什麼是位元組數組？為什麼要轉換 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

上面的程式碼演示了兩種轉換方法。 BinaryData屬性提供了最直接的方法，可立即傳回位元組數組表示形式。 對於需要進行流程操作的場景， Stream屬性提供了一個MemoryStream實例，您可以使用ToArray()方法將其轉換為位元組。

如何將現有 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

上面的程式碼展示了處理現有文件的兩種方法。 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

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

本範例示範了使用記憶體流建立、儲存和載入 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

為了有效率地儲存和檢索，請考慮以下做法：使用完畢後釋放PdfDocument對象，對大檔案使用串流以避免記憶體問題，並為檔案操作實現適當的錯誤處理。

結論

IronPDF 簡化了 PDF 到位元組數組的 C# 轉換，為開發人員提供了強大而簡單的方法來處理作為二進位資料的 PDF 文件。 無論您是建立 API、管理文件資料庫或建立 Web 應用程序，IronPDF 的BinaryData和Stream屬性都能提供現代 PDF 處理所需的靈活性。 我們希望本文能幫助您了解如何將 PDF 文件轉換為位元組數組並進行保存和操作。