如何使用 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文檔整合到應用程序中的麻煩。 無論您是想將簡單的文本文檔添加並集成到應用程式中，還是創建複雜的表格和報告以展示給使用者，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. 易於使用和廣泛支援： IronWord 配備易於理解的 API 和簡單的方法調用，還提供擴展 API 參考和代碼範例，以幫助開發人員確定使用 IronWord 的最佳方式。

在 Visual Studio 中創建一個新的控制台專案

在我們深入示例之前，讓我們先在 中創建一個空白的控制台項目。Visual Studio.

然後，我們為專案提供一個名稱和儲存位置。

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

在創建和設置新的控制台專案後，讓我們安裝 C# word 庫，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. 程式碼將 Word 文件儲存為「document.docx」以供日後使用。

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 文件中。 其餘部分與其他示例相同。

控制台輸出

結論

在整個範例中，我們展示了使用這個工具是多麼簡單明瞭IronWord用於以 C# 程式操控和讀取 Word 文件的函式庫。 IronWord 函式庫的靈活性和可擴展性使其成為一個有價值的工具，允許開發者在實際應用中使用它，例如填寫模板、生成報告和批量處理文件。 了解 Word 如何與應用程式整合非常有價值，因為這讓開發者對他們的問題有更多的解決方案。

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

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