如何使用 C# 讀取 Word 檔案

在現今這個時代，Microsoft Word 文件已經成為辦公工作以及專業和個人通信的代名詞。因此，對於開發人員來說，要在應用程式中向用戶展示並自動化任務，程序化地操作 Word 文件顯得極為重要。儘管市面上有許多可用的庫，但並非所有庫都同樣強大。然而，有一個突出於眾的競爭者是 IronWord. IronWord 是一個可靠且強大的 C# Word DOCX 庫，易於使用和理解，並簡化了處理 Word 文件的工作。

這篇文章將探討如何快速利用 IronWord 讀取 Word 文件的簡短示例。

如何使用 C# 讀取 Word 文件

1. 在 Visual Studio 中建立主控台應用程式

2. 安裝 IronWord C# DOCX 函式庫

3. 使用 WordDocument 類別創建新的 Word 文件

4. 向 Word 文件添加文本

5. 使用 Paragraph 類別遍歷每個段落

6. 顯示內容

IronWord：C# DOCX 函式庫

IronWord 是一個靈活且可擴展的庫，具有簡單易用的API，消除了將Word文檔集成到應用程序中的麻煩。無論您是想將簡單的文本Word文檔添加和集成到您的應用程序中，還是創建複雜的表格和報表來顯示給用戶，IronWord都一應俱全。

以下是它最顯著的功能：

1. 文件操作：IronWord允許開發人員輕鬆操作Word文檔。無論用戶是想插入段落文本還是更複雜的結構如表格和圖片，IronWord都能夠完成。

2. 跨平台支持與兼容性：IronWord被設計為靈活，支援多平台開發者。它支持各種.NET Core。 (8, 7, 6, 5, 和 3.1+).NET Standard (2.0+).NET 框架 (4.6.2+)，甚至是 Azure。此外，開發人員可以在不同的平台和系統上使用 IronWord，包括但不限於 Windows、Linux、macOS 和 Android。它涵蓋了最常見的平台，允許開發人員快速構建跨平台應用程式。

3. 獨立於 Microsoft Office：在 .Net 應用程式中整合 Word 文檔時，一個常見的問題是像 Interop 這樣的流行庫需要安裝有許可的 Microsoft Office。然而，IronWord 通過不受這種限制的獨立性減輕了這個問題。開發人員可以充分利用 Word 文檔的強大功能，而不受 Microsoft Word 許可和安裝的限制。

4. 格式選項： IronWord 提供廣泛的格式化和樣式支持，允許開發人員使文檔變得獨特。開發人員可以套用 字體到他們的文本，顏色對齊和其他複雜的格式，例如 表格樣式5. 易於使用和廣泛支持：除了易於理解的API和簡單明了的方法調用，IronWord還提供擴展API參考和代碼示例，以幫助開發人員確定最優使用IronWord的方法。

在 Visual Studio 中建立新的控制台專案

在進入範例之前，讓我們先在 Visual Studio 中建立一個空白的控制台專案。 Visual Studio.

接下來，我們為專案提供名稱和儲存位置。

接下來，選擇您將使用的 .NET 框架。在此範例中，我將使用 .NET 8.0。

在創建並設置新的控制台項目後，讓我們安裝 C# 字庫， IronWord.

安裝 IronWord

有兩種方式可以安裝 IronWord。

1. 通過NuGet包管理器安裝

要通過NuGet包管理器安裝，點擊工具，然後選擇「管理NuGet解決方案」。我們在搜索欄中搜索IronWord，然後安裝`IronWord。`

2. 通過 NuGet 套件管理器控制台安裝

另一種方法是通過 NuGet 套件管理器控制台進行安裝。為此，在控制台中運行以下命令：

Install-Package IronWord

Install-Package IronWord

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Install-Package IronWord

許可金鑰

請注意，IronWord 沒有許可金鑰無法運作；您可以在這裡獲取一個，作為 免費試用取得試用金鑰後，請確保在您的專案中設定此變數。

//Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";

//Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";

IRON VB CONVERTER ERROR developers@ironsoftware.com

在 C# 中讀取 Word 文件

在安裝必要條件後，我們將展示使用 Microsoft Word 文件讀取的簡單性 IronWord 在以下程式碼中。

首先，我們匯入下列命名空間。使用 IronWord，我們創建一個新文件並添加示範文本。然後，我們使用 WordDocument 對象訪問段落和文本，並打印出 Word 文件中的文本。

using IronWord;
using IronWord.Models;
using SixLabors.Fonts;

# region
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion
// Create textrun
Text textRunExample = new Text("Sample text");

Paragraph paragraphExample = new Paragraph();
paragraphExample.AddChild(textRunExample);

// Create a new Word document
WordDocument doc = new WordDocument(paragraphExample);

// Export docx
doc.SaveAs("document.docx");

// Access paragraphs and text runs

foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display Contents
        Console.WriteLine(content);
    }
}

using IronWord;
using IronWord.Models;
using SixLabors.Fonts;

# region
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion
// Create textrun
Text textRunExample = new Text("Sample text");

Paragraph paragraphExample = new Paragraph();
paragraphExample.AddChild(textRunExample);

// Create a new Word document
WordDocument doc = new WordDocument(paragraphExample);

// Export docx
doc.SaveAs("document.docx");

// Access paragraphs and text runs

foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display Contents
        Console.WriteLine(content);
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

讓我們探討如何使用上述程式碼讀取 Word 文件的各種方法和參數。

1. 我們首先創建一個 Text 物件，並將字串 "Sample Text" 指派給它。

2. 然後我們實例化一個 Paragraph 物件，並將 "textRunExample" 添加到它。

3. 我們還實例化了一個 WordDocument 物件，將其命名為 `WordDocument doc`，並將 `paragraphExample` 傳遞給它，以創建包含該段落的新 Word 文件。

4. 程式碼使用檔案名 "document.docx" 保存這個 Word 文件以供日後使用。

5. 要訪問我們剛剛創建的 Word 文件中的段落，我們訪問 WordDocument 物件的 "Paragraphs" 屬性。"Paragraphs" 屬性是一個列表。因此，我們調用 foreach 循環對其進行迭代。

6. 要獲取段落中的文字，我們訪問 Paragraphs 的 "Texts" 屬性，這也會返回一個 Text 列表。

7. 最後，我們將 Text 指派給一個名為 "content" 的字串變量，並將其打印到控制台。

控制台輸出

使用 C# 讀取現有的 Word 文件

在上一個範例中，我們藉由編程方式創建了一個新的 Word 文件並讀取其內容。我們可以透過進行一些代碼變更來讀取現有的 Word 文件，遵循類似的步驟。

輸入文件

using IronWord;
using IronWord.Models;
using SixLabors.Fonts;

# region
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Export docx
WordDocument doc = new WordDocument("existing_document.docx");

// Access paragraphs and text runs

foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display Contents
        Console.WriteLine(content);
    }
}

using IronWord;
using IronWord.Models;
using SixLabors.Fonts;

# region
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Export docx
WordDocument doc = new WordDocument("existing_document.docx");

// Access paragraphs and text runs

foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display Contents
        Console.WriteLine(content);
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

這兩個範例之間的主要區別是傳遞給 WordDocument 對象的參數。我們加載一個現有的 Word 文件，而不是創建一個新文件。其餘部分與另一個範例相同。

控制台輸出

結論

在這些範例中，我們展示了使用Iron Software產品是多麼簡單。 IronWord 在 C# 中以程式化方式操作和閱讀 Word 文件的庫。IronWord 庫的靈活性和可擴展性使其成為一個寶貴的工具，允許開發人員在實際、真實的例子中使用 IronWord，例如填寫模板、生成報告和批量處理文件。理解 Word 如何與應用集成是非常有價值的，因為這為開發人員提供了更多解決方案。

此外，開發人員可以在購買前測試 IronWord 的廣泛功能，因為它提供了一個 免費試用 授權。除了易於使用外，IronWord 還附帶詳細的 文檔 和 24/5 支援 為開發人員減輕在生產過程中可能面臨的持續挫折。我們也提供各種 教程 以及一系列 代碼範例 以幫助您開始使用 IronWord 的參考指南。

在測試了各種功能之後 IronWord 使用試用授權，您可以購買我們的 Lite 開發者授權，價格從 $599 起步，並可升級至 Professional。請參閱我們的 授權 更多資訊請參閱頁面。