跳過到頁腳內容
使用IRONPDF

如何在C#中讀取PDF表格

Extracting structured table data from PDF documents is a frequent necessity for C# developers, crucial for data analysis, reporting, or integrating information into other systems. However, PDFs are primarily designed for consistent visual presentation, not straightforward data extraction. This can make reading tables from PDF files programmatically in C# a challenging task, especially as tables can vary widely—from simple text-based grids to complex layouts with merged cells, or even tables embedded as images in scanned documents.

This guide provides a comprehensive C# tutorial on how to approach PDF table extraction using IronPDF. We will primarily explore leveraging IronPDF's powerful text extraction capabilities to access and then parse tabular data from text-based PDFs. We'll discuss the effectiveness of this method, provide strategies for parsing, and offer insights into handling the extracted information. Additionally, we'll touch upon strategies for tackling more complex scenarios, including scanned PDFs.


Key Steps to Extract Table Data from PDFs in C#

  1. Install the IronPDF C# Library (https://nuget.org/packages/IronPdf/) for PDF processing.
  2. (Optional Demo Step) Create a sample PDF with a table from an HTML string using IronPDF's RenderHtmlAsPdf. (See section: (Demo Step) Create a PDF Document with Table Data)
  3. Load any PDF document and use the ExtractAllText method to retrieve its raw text content. (See section: Extract All Text Containing Table Data from the PDF)
  4. Implement C# logic to parse the extracted text and identify table rows and cells. (See section: Parsing Extracted Text to Reconstruct Table Data in C#)
  5. Output the structured table data or save it to a CSV file for further use. (See section: Parsing Extracted Text to Reconstruct Table Data in C#)
  6. Consider advanced techniques like OCR for scanned PDFs (discussed later).

IronPDF - C# PDF Library

IronPDF is a C# .NET Library solution for PDF manipulation in .NET (https://ironpdf.com/), that helps developers read, create, and edit PDF documents easily in their software applications. Its robust Chromium Engine renders PDF documents from HTML with high accuracy and speed. It allows developers to convert from different formats to PDF and vice versa seamlessly. It supports the latest .NET frameworks including .NET 7, .NET 6, 5, 4, .NET Core, and Standard.

Moreover, the IronPDF .NET API also enables developers to manipulate and edit PDFs, add headers and footers, and importantly, extract text, images, and (as we'll see) table data from PDFs with ease.

Some Important Features include:

Steps to Extract Table Data in C# using IronPDF Library

To extract table data from PDF documents, we'll set up a C# project:

  1. Visual Studio: Ensure you have Visual Studio (e.g., 2022) installed. If not, download it from the Visual Studio website (https://visualstudio.microsoft.com/downloads/).
  2. Create Project:

    • Open Visual Studio 2022 and click on Create a new project.

      How to Read PDF Table in C#, Figure 1: Visual Studio's start screen Visual Studio's start screen

    • Select "Console App" (or your preferred C# project type) and click Next.

      How to Read PDF Table in C#, Figure 2: Create a new Console Application in Visual Studio Create a new Console Application in Visual Studio

    • Name your project (e.g., "ReadPDFTableDemo") and click Next. How to Read PDF Table in C#, Figure 3:  Configure the newly created application Configure the newly created application

    • Choose your desired .NET Framework (e.g., .NET 6 or later). How to Read PDF Table in C#, Figure 4: Select a .NET Framework Select a .NET Framework

    • Click Create. The console project will be created.
  3. Install IronPDF:

    • Using Visual Studio NuGet Package Manager:

      • Right-click your project in Solution Explorer and select "Manage NuGet Packages..."

      How to Read PDF Table in C#, Figure 5: Tools & Manage NuGet Packages Tools & Manage NuGet Packages

      • In the NuGet Package Manager, browse for "IronPdf" and click "Install". How to Read PDF Table in C#, Figure 6: Tools & Manage NuGet Packages Tools & Manage NuGet Packages
    • Download NuGet Package directly: Visit IronPDF's NuGet package page (https://www.nuget.org/packages/IronPdf/).
    • Download IronPDF .DLL Library: Download from the official IronPDF website and reference the DLL in your project.

(Demo Step) Create a PDF Document with Table Data

For this tutorial, we'll first create a sample PDF containing a simple table from an HTML string. This gives us a known PDF structure to demonstrate the extraction process. In a real-world scenario, you would load your pre-existing PDF files.

Add the IronPDF namespace and optionally set your license key (IronPDF is free for development but requires a license for commercial deployment without watermarks):

using IronPdf;
using System;       // For StringSplitOptions, Console
using System.IO;    // For StreamWriter

// Apply your license key if you have one. Otherwise, IronPDF runs in trial mode.
// License.LicenseKey = "YOUR-TRIAL/PURCHASED-LICENSE-KEY";
using IronPdf;
using System;       // For StringSplitOptions, Console
using System.IO;    // For StreamWriter

// Apply your license key if you have one. Otherwise, IronPDF runs in trial mode.
// License.LicenseKey = "YOUR-TRIAL/PURCHASED-LICENSE-KEY";
Imports IronPdf
Imports System ' For StringSplitOptions, Console
Imports System.IO ' For StreamWriter

' Apply your license key if you have one. Otherwise, IronPDF runs in trial mode.
' License.LicenseKey = "YOUR-TRIAL/PURCHASED-LICENSE-KEY";
$vbLabelText   $csharpLabel

Here's the HTML string for our sample table:

string HTML = "<html>" +
        "<style>" +
            "table, th, td {" +
                "border:1px solid black;" +
            "}" +
        "</style>" +
        "<body>" +
            "<h1>A Simple table example</h1>" + // Corrected typo: h1 not h2
            "<table>" +
                "<tr>" +
                    "<th>Company</th>" +
                    "<th>Contact</th>" +
                    "<th>Country</th>" +
               "</tr>" +
                "<tr>" +
                    "<td>Alfreds Futterkiste</td>" +
                    "<td>Maria Anders</td>" +
                    "<td>Germany</td>" +
                "</tr>" +
                "<tr>" +
                    "<td>Centro comercial Moctezuma</td>" +
                    "<td>Francisco Chang</td>" +
                    "<td>Mexico</td>" +
                "</tr>" +
            "</table>" +
            "<p>To understand the example better, we have added borders to the table.</p>" +
        "</body>" +
        "</html>";
string HTML = "<html>" +
        "<style>" +
            "table, th, td {" +
                "border:1px solid black;" +
            "}" +
        "</style>" +
        "<body>" +
            "<h1>A Simple table example</h1>" + // Corrected typo: h1 not h2
            "<table>" +
                "<tr>" +
                    "<th>Company</th>" +
                    "<th>Contact</th>" +
                    "<th>Country</th>" +
               "</tr>" +
                "<tr>" +
                    "<td>Alfreds Futterkiste</td>" +
                    "<td>Maria Anders</td>" +
                    "<td>Germany</td>" +
                "</tr>" +
                "<tr>" +
                    "<td>Centro comercial Moctezuma</td>" +
                    "<td>Francisco Chang</td>" +
                    "<td>Mexico</td>" +
                "</tr>" +
            "</table>" +
            "<p>To understand the example better, we have added borders to the table.</p>" +
        "</body>" +
        "</html>";
HTML

Now, use ChromePdfRenderer to create a PDF from this HTML:

var renderer = new ChromePdfRenderer();
PdfDocument pdfDocument = renderer.RenderHtmlAsPdf(HTML);
pdfDocument.SaveAs("table_example.pdf");
Console.WriteLine("Sample PDF 'table_example.pdf' created.");
var renderer = new ChromePdfRenderer();
PdfDocument pdfDocument = renderer.RenderHtmlAsPdf(HTML);
pdfDocument.SaveAs("table_example.pdf");
Console.WriteLine("Sample PDF 'table_example.pdf' created.");
Dim renderer = New ChromePdfRenderer()
Dim pdfDocument As PdfDocument = renderer.RenderHtmlAsPdf(HTML)
pdfDocument.SaveAs("table_example.pdf")
Console.WriteLine("Sample PDF 'table_example.pdf' created.")
$vbLabelText   $csharpLabel

The SaveAs method saves the PDF. The generated table_example.pdf will look like this (conceptual image based on HTML):

How to Read PDF Table in C#, Figure 7: Search for IronPDF in NuGet Package Manager UI Search for IronPDF in NuGet Package Manager UI

Extract All Text Containing Table Data from the PDF

To extract table data, we first load the PDF (either the one we just created or any existing PDF) and use the ExtractAllText method. This method retrieves all textual content from the PDF pages.

// Load the PDF (if you just created it, it's already loaded in pdfDocument)
// If loading an existing PDF:
// PdfDocument pdfDocument = PdfDocument.FromFile("table_example.pdf"); 
// Or use the one created above:
string allText = pdfDocument.ExtractAllText();
// Load the PDF (if you just created it, it's already loaded in pdfDocument)
// If loading an existing PDF:
// PdfDocument pdfDocument = PdfDocument.FromFile("table_example.pdf"); 
// Or use the one created above:
string allText = pdfDocument.ExtractAllText();
' Load the PDF (if you just created it, it's already loaded in pdfDocument)
' If loading an existing PDF:
' PdfDocument pdfDocument = PdfDocument.FromFile("table_example.pdf"); 
' Or use the one created above:
Dim allText As String = pdfDocument.ExtractAllText()
$vbLabelText   $csharpLabel

The allText variable now holds the entire text content from the PDF. You can display it to see the raw extraction:

Console.WriteLine("\n--- Raw Extracted Text ---");
Console.WriteLine(allText);
Console.WriteLine("\n--- Raw Extracted Text ---");
Console.WriteLine(allText);
Imports Microsoft.VisualBasic

Console.WriteLine(vbLf & "--- Raw Extracted Text ---")
Console.WriteLine(allText)
$vbLabelText   $csharpLabel

How to Read PDF Table in C#, Figure 8: The PDF file to extract text The PDF file to extract text

Parsing Extracted Text to Reconstruct Table Data in C#

With the raw text extracted, the next challenge is to parse this string to identify and structure the tabular data. This step is highly dependent on the consistency and format of the tables in your PDFs.

General Parsing Strategies:

  1. Identify Row Delimiters: Newline characters (\n or \r\n) are common row separators.
  2. Identify Column Delimiters: Cells within a row might be separated by multiple spaces, tabs, or specific known characters (like '|' or ';'). Sometimes, if columns are visually aligned but lack clear text delimiters, you might infer structure based on consistent spacing patterns, although this is more complex.
  3. Filter Non-Table Content: The ExtractAllText method gets all text. You'll need logic to isolate the text that actually forms your table, possibly by looking for header keywords or skipping preamble/postamble text.

The C# String.Split method is a basic tool for this. Here's an example that attempts to extract only the table lines from our sample, filtering out lines with periods (a simple heuristic for this specific example):

Console.WriteLine("\n--- Parsed Table Data (Simple Heuristic) ---");
string[] textLines = allText.Split(new[] { '\r', '\n' }, StringSplitOptions.RemoveEmptyEntries);
foreach (string line in textLines)
{
    // Simple filter: skip lines with a period, assuming they are not table data in this example
    // and skip lines that are too short or headers if identifiable
    if (line.Contains(".") || line.Contains("A Simple table example") || line.Length < 5) 
    {
        continue;
    }
    else
    {
        // Further split line into cells based on expected delimiters (e.g., multiple spaces)
        // This part requires careful adaptation to your PDF's table structure
        // Example: string[] cells = line.Split(new[] { "  ", "\t" }, StringSplitOptions.None);
        Console.WriteLine(line); // For now, just print the filtered line
    }
}
Console.WriteLine("\n--- Parsed Table Data (Simple Heuristic) ---");
string[] textLines = allText.Split(new[] { '\r', '\n' }, StringSplitOptions.RemoveEmptyEntries);
foreach (string line in textLines)
{
    // Simple filter: skip lines with a period, assuming they are not table data in this example
    // and skip lines that are too short or headers if identifiable
    if (line.Contains(".") || line.Contains("A Simple table example") || line.Length < 5) 
    {
        continue;
    }
    else
    {
        // Further split line into cells based on expected delimiters (e.g., multiple spaces)
        // This part requires careful adaptation to your PDF's table structure
        // Example: string[] cells = line.Split(new[] { "  ", "\t" }, StringSplitOptions.None);
        Console.WriteLine(line); // For now, just print the filtered line
    }
}
Imports Microsoft.VisualBasic

Console.WriteLine(vbLf & "--- Parsed Table Data (Simple Heuristic) ---")
Dim textLines() As String = allText.Split( { ControlChars.Cr, ControlChars.Lf }, StringSplitOptions.RemoveEmptyEntries)
For Each line As String In textLines
	' Simple filter: skip lines with a period, assuming they are not table data in this example
	' and skip lines that are too short or headers if identifiable
	If line.Contains(".") OrElse line.Contains("A Simple table example") OrElse line.Length < 5 Then
		Continue For
	Else
		' Further split line into cells based on expected delimiters (e.g., multiple spaces)
		' This part requires careful adaptation to your PDF's table structure
		' Example: string[] cells = line.Split(new[] { "  ", "\t" }, StringSplitOptions.None);
		Console.WriteLine(line) ' For now, just print the filtered line
	End If
Next line
$vbLabelText   $csharpLabel

This code splits the text into lines. The if condition is a very basic filter for this specific example's non-table text. In real-world scenarios, you would need more robust logic to identify and parse table rows and cells accurately.

Output of the simple filtered text:

How to Read PDF Table in C#, Figure 9: The Console displays extracted texts The Console displays extracted texts

Important Considerations for Text-Parsing Method:

  • Best Suited For: Text-based PDFs with simple, consistent table structures and clear textual delimiters.
  • Limitations: This method can struggle with:
    • Tables with merged cells or complex nested structures.
    • Tables where columns are defined by visual spacing rather than text delimiters.
    • Tables embedded as images (requiring OCR).
    • Variations in PDF generation leading to inconsistent text extraction order.

You can save the filtered lines (which ideally represent table rows) to a CSV file:

using (StreamWriter file = new StreamWriter("parsed_table_data.csv", false))
{
    file.WriteLine("Company,Contact,Country"); // Write CSV Header
    foreach (string line in textLines)
    {
        if (line.Contains(".") || line.Contains("A Simple table example") || line.Length < 5)
        {
            continue;
        }
        else
        {
            // For a real CSV, you'd split 'line' into cells and join with commas
            // E.g., string[] cells = line.Split(new[] {"  "}, StringSplitOptions.RemoveEmptyEntries);
            // string csvLine = string.Join(",", cells);
            // file.WriteLine(csvLine);
            file.WriteLine(line.Replace("  ", ",").Trim()); // Basic replacement for this example
        }
    }
}
Console.WriteLine("\nFiltered table data saved to parsed_table_data.csv");
using (StreamWriter file = new StreamWriter("parsed_table_data.csv", false))
{
    file.WriteLine("Company,Contact,Country"); // Write CSV Header
    foreach (string line in textLines)
    {
        if (line.Contains(".") || line.Contains("A Simple table example") || line.Length < 5)
        {
            continue;
        }
        else
        {
            // For a real CSV, you'd split 'line' into cells and join with commas
            // E.g., string[] cells = line.Split(new[] {"  "}, StringSplitOptions.RemoveEmptyEntries);
            // string csvLine = string.Join(",", cells);
            // file.WriteLine(csvLine);
            file.WriteLine(line.Replace("  ", ",").Trim()); // Basic replacement for this example
        }
    }
}
Console.WriteLine("\nFiltered table data saved to parsed_table_data.csv");
Imports Microsoft.VisualBasic

Using file As New StreamWriter("parsed_table_data.csv", False)
	file.WriteLine("Company,Contact,Country") ' Write CSV Header
	For Each line As String In textLines
		If line.Contains(".") OrElse line.Contains("A Simple table example") OrElse line.Length < 5 Then
			Continue For
		Else
			' For a real CSV, you'd split 'line' into cells and join with commas
			' E.g., string[] cells = line.Split(new[] {"  "}, StringSplitOptions.RemoveEmptyEntries);
			' string csvLine = string.Join(",", cells);
			' file.WriteLine(csvLine);
			file.WriteLine(line.Replace("  ", ",").Trim()) ' Basic replacement for this example
		End If
	Next line
End Using
Console.WriteLine(vbLf & "Filtered table data saved to parsed_table_data.csv")
$vbLabelText   $csharpLabel

Strategies for More Complex PDF Table Extraction in C#

Extracting data from complex or image-based PDF tables often requires more advanced techniques than simple text parsing. IronPDF provides features that can assist:

  • Using IronOCR's Capabilities for Scanned Tables: If tables are within images (e.g., scanned PDFs), ExtractAllText() alone won't capture them. IronOCR's text detection functionality can convert these images to text first.
// Conceptual OCR usage (refer to IronOCR's documentation for detailed implementation)
// Install Package IronOcr
using IronOcr;
using (var ocrInput = new OcrInput("scanned_pdf_with_table.pdf"))
{
     ocrInput.TargetDPI = 300; // Good DPI for OCR accuracy
     var ocrResult = new IronOcr().Read(ocrInput);
     string ocrExtractedText = ocrResult.Text;
     // Now, apply parsing logic to 'ocrExtractedText'
     Console.WriteLine("\n--- OCR Extracted Text for Table Parsing ---");
     Console.WriteLine(ocrExtractedText);
}
// Conceptual OCR usage (refer to IronOCR's documentation for detailed implementation)
// Install Package IronOcr
using IronOcr;
using (var ocrInput = new OcrInput("scanned_pdf_with_table.pdf"))
{
     ocrInput.TargetDPI = 300; // Good DPI for OCR accuracy
     var ocrResult = new IronOcr().Read(ocrInput);
     string ocrExtractedText = ocrResult.Text;
     // Now, apply parsing logic to 'ocrExtractedText'
     Console.WriteLine("\n--- OCR Extracted Text for Table Parsing ---");
     Console.WriteLine(ocrExtractedText);
}
' Conceptual OCR usage (refer to IronOCR's documentation for detailed implementation)
' Install Package IronOcr
Imports Microsoft.VisualBasic
Imports IronOcr
Using ocrInput As New OcrInput("scanned_pdf_with_table.pdf")
	 ocrInput.TargetDPI = 300 ' Good DPI for OCR accuracy
	 Dim ocrResult = (New IronOcr()).Read(ocrInput)
	 Dim ocrExtractedText As String = ocrResult.Text
	 ' Now, apply parsing logic to 'ocrExtractedText'
	 Console.WriteLine(vbLf & "--- OCR Extracted Text for Table Parsing ---")
	 Console.WriteLine(ocrExtractedText)
End Using
$vbLabelText   $csharpLabel

For detailed guidance, visit the IronOCR documentation (https://ironsoftware.com/csharp/ocr/). After OCR, you'd parse the resulting text string.

  • Coordinate-Based Text Extraction (Advanced): While IronPDF's ExtractAllText() provides the text stream, some scenarios might benefit from knowing the x,y coordinates of each text snippet. If IronPDF offers APIs to get text with its bounding box information (check current documentation), this could allow for more sophisticated spatial parsing to reconstruct tables based on visual alignment.

  • Converting PDF to Another Format: IronPDF can convert PDFs to structured formats like HTML. Often, parsing an HTML table is more straightforward than parsing raw PDF text.
PdfDocument pdfToConvert = PdfDocument.FromFile("your_document.pdf");
string htmlOutput = pdfToConvert.ToHtmlString();
// Then use an HTML parsing library (e.g., HtmlAgilityPack) to extract tables from htmlOutput.
PdfDocument pdfToConvert = PdfDocument.FromFile("your_document.pdf");
string htmlOutput = pdfToConvert.ToHtmlString();
// Then use an HTML parsing library (e.g., HtmlAgilityPack) to extract tables from htmlOutput.
Dim pdfToConvert As PdfDocument = PdfDocument.FromFile("your_document.pdf")
Dim htmlOutput As String = pdfToConvert.ToHtmlString()
' Then use an HTML parsing library (e.g., HtmlAgilityPack) to extract tables from htmlOutput.
$vbLabelText   $csharpLabel
  • Pattern Recognition and Regular Expressions: For tables with very predictable patterns but inconsistent delimiters, complex regular expressions applied to the extracted text can sometimes isolate table data.

Choosing the right strategy depends on the complexity and consistency of your source PDFs. For many common business documents with text-based tables, IronPDF's ExtractAllText coupled with smart C# parsing logic can be very effective. For image-based tables, its OCR capabilities are essential.

Summary

This article demonstrated how to extract table data from a PDF document in C# using IronPDF, primarily focusing on leveraging the ExtractAllText() method and subsequent string parsing. We've seen that while this approach is powerful for text-based tables, more complex scenarios like image-based tables can be addressed using IronPDF's OCR features or by converting PDFs to other formats first.

IronPDF provides a versatile toolkit for .NET developers, simplifying many PDF-related tasks, from creation and editing to comprehensive data extraction. It offers methods like ExtractTextFromPage for page-specific extraction and supports conversions from formats like markdown or DOCX to PDF.

IronPDF is free for development and offers a free trial license for testing its full commercial features. For production deployment, various licensing options are available.

For more details and advanced use cases, explore the official IronPDF documentation and examples (https://ironpdf.com/)

常見問題解答

如何使用 C# 以程式設計方式讀取 PDF 文件中的表格?

您可以使用 IronPDF 的 `ExtractAllText` 方法從 PDF 文件中提取原始文字。提取後,您可以使用 C# 解析此文字以識別表格行和單元格,從而實現結構化資料提取。

使用 C# 從 PDF 擷取表格資料涉及哪些步驟?

該過程包括安裝 IronPDF 庫,使用 `ExtractAllText` 方法檢索文本,解析此文本以識別表格,並可選擇將結構化資料儲存為 CSV 等格式。

如何在 C# 中處理包含表格的掃描版 PDF 檔案?

對於掃描的 PDF 文件,IronPDF 可以利用 OCR(光學字元辨識)將表格影像轉換為文本,然後解析文字以提取表格資料。

IronPDF能否將PDF文件轉換為其他格式以便更輕鬆地提取表格?

是的,IronPDF 可以將 PDF 轉換為 HTML,從而允許開發人員使用 HTML 解析技術來簡化表格提取。

IronPDF 是否適用於從複雜的 PDF 表格中提取數據?

IronPDF 提供 OCR 和基於座標的文字擷取等進階功能,可用於處理複雜的表格佈局,包括合併儲存格或不一致分隔符號的表格佈局。

如何將 IronPDF 整合到 .NET Core 應用程式中?

IronPDF 與 .NET Core 應用程式相容。您可以透過 Visual Studio 中的 NuGet 套件管理器安裝庫來整合它。

在 C# 中使用 IronPDF 進行 PDF 處理有哪些好處?

IronPDF 提供了一系列功能,用於建立、編輯和提取 PDF 中的數據,包括支援 OCR 和轉換為各種格式,使其成為 .NET 開發人員的強大工具。

從 PDF 文件中提取表格資料時,常見的挑戰有哪些?

挑戰包括處理複雜的表格佈局,例如合併的單元格、嵌入為圖像的表格以及不一致的分隔符,這可能需要高級解析策略或 OCR。

我該如何開始使用 IronPDF 進行 PDF 處理?

首先,透過 NuGet 套件管理器安裝 IronPDF 庫,或從 IronPDF 網站下載安裝。此設定對於在 C# 專案中使用其 PDF 處理功能至關重要。

使用 IronPDF 需要許可證嗎?

IronPDF 可免費用於開發用途,但商業部署需要許可證才能移除浮水印。我們提供免費試用許可證,方便您測試其全部功能。

IronPDF 在從 PDF 中提取表格時是否相容於 .NET 10?

是的。 IronPDF 支援 .NET 10(以及 .NET 9、8、7、6、Core、Standard 和 Framework),因此所有表格提取功能在 .NET 10 應用程式中無需修改即可運行。

Curtis Chau
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外,Curtis 對物聯網 (IoT) 有著濃厚的興趣,探索將硬體和軟體結合的創新方式。在閒暇時間,他喜愛遊戲並構建 Discord 機器人,結合科技與創意的樂趣。