如何使用 C# 讀取 Word 檔案

如何使用 C# 讀取 Word 文件

1. 在 Visual Studio 中建立一個控制台應用程式

2. 安裝 IronWord C# DOCX 函式庫

3. 使用WordDocument類別建立一個新的 Word 文檔

4. 在 Word 文件中新增文本

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

6. 顯示內容

IronWord：C# DOCX 庫

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 Framework（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中建立一個空白的控制台專案。

建立新專案時，請點擊控制台應用程式

然後我們為項目提供名稱和保存位置。

! 指定項目的名稱和位置路徑。

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

選擇所需的 .NET 框架，然後按一下"建立"。

建立並設定新的控制台專案後，讓我們安裝我們的 C# 單字庫IronWord 。

安裝 IronWord

安裝 IronWord 有兩種方法。

Install-Package 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";

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

在 C# 中讀取 Word 文檔

安裝必備元件後，我們將透過以下程式碼示範使用IronWord讀取 Microsoft Word 文件的簡易性。

首先，我們導入必要的命名空間。 使用 IronWord，我們建立一個新文件並添加範例文字。 然後我們使用WordDocument物件存取段落和文本，以列印 Word 文件中的文字。

using IronWord;
using IronWord.Models;

#region Licensing
// Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Create text run with sample text
Text textRunExample = new Text("Sample text");

// Create a paragraph and add the text run to it
Paragraph paragraphExample = new Paragraph();
paragraphExample.AddChild(textRunExample);

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

// Export the document as a DOCX file
doc.SaveAs("document.docx");

// Access paragraphs and text runs within the document
foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display the content to the console
        Console.WriteLine(content);
    }
}

using IronWord;
using IronWord.Models;

#region Licensing
// Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Create text run with sample text
Text textRunExample = new Text("Sample text");

// Create a paragraph and add the text run to it
Paragraph paragraphExample = new Paragraph();
paragraphExample.AddChild(textRunExample);

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

// Export the document as a DOCX file
doc.SaveAs("document.docx");

// Access paragraphs and text runs within the document
foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display the content to the console
        Console.WriteLine(content);
    }
}

Imports IronWord
Imports IronWord.Models

#Region "Licensing"
' Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE"
'#End Region

' Create text run with sample text
Dim textRunExample As New Text("Sample text")

' Create a paragraph and add the text run to it
Dim paragraphExample As New Paragraph()
paragraphExample.AddChild(textRunExample)

' Create a new Word document with the paragraph
Dim doc As New WordDocument(paragraphExample)

' Export the document as a DOCX file
doc.SaveAs("document.docx")

' Access paragraphs and text runs within the document
For Each paragraph As Paragraph In doc.Paragraphs
	For Each textRun As Text In paragraph.Texts
		' Access text content
		Dim content As String = textRun.Text
		' Display the content to the console
		Console.WriteLine(content)
	Next textRun
Next paragraph

讓我們來探討一下從上面的程式碼中讀取 word 檔案的方法和參數。

1. 我們先建立一個Text對象，並將字串"範例文字"賦值給它。

2. 然後我們實例化一個Paragraph對象，並將"textRunExample"加入到該物件中。

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

4. 程式碼將 Word 文件儲存為檔案名稱"document.docx"，以便稍後使用。

5. 要存取我們剛剛建立的 Word 文件中的段落，我們可以存取WordDocument物件的"Paragraphs"屬性。 "Paragraphs"屬性是一個列表。因此，我們需要使用foreach循環來遍歷它。

6. 要取得段落中的文本，我們可以存取Paragraphs的"Texts"屬性。 這也會傳回一個文字清單。

7. 最後，我們將文字賦值給名為"content"的字串變量，並將其印到控制台。

using IronWord;
using IronWord.Models;

#region Licensing
// Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Load an existing Word document
WordDocument doc = new WordDocument("existing_document.docx");

// Access paragraphs and text runs within the document
foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display the content to the console
        Console.WriteLine(content);
    }
}

using IronWord;
using IronWord.Models;

#region Licensing
// Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Load an existing Word document
WordDocument doc = new WordDocument("existing_document.docx");

// Access paragraphs and text runs within the document
foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display the content to the console
        Console.WriteLine(content);
    }
}

Imports IronWord
Imports IronWord.Models

#Region "Licensing"
' Set the IronWord license key before using the IronWord functionalities
IronWord.License.LicenseKey = "YOUR-KEY-HERE"
'#End Region

' Load an existing Word document
Dim doc As New WordDocument("existing_document.docx")

' Access paragraphs and text runs within the document
For Each paragraph As Paragraph In doc.Paragraphs
	For Each textRun As Text In paragraph.Texts
		' Access text content
		Dim content As String = textRun.Text
		' Display the content to the console
		Console.WriteLine(content)
	Next textRun
Next paragraph

結論

IronWord 授權資訊

在這些範例中，我們示範了使用IronWord庫以程式設計方式在 C# 中操作和讀取 Word 文件是多麼簡單。 IronWord庫的靈活性和可擴展性使其成為一個有價值的工具，使開發人員能夠在實際的、真實的範例中使用 IronWord，例如填寫範本、產生報告和批量處理文件。 了解 Word 如何與應用程式整合非常重要，因為它能為開發人員提供更多解決問題的方案。

此外，開發者可以在購買前試用IronWord 的豐富功能一段時間，因為它提供免費試用授權。 除了易於使用之外，IronWord 還附帶詳盡的文件和 24/5 全天候支持，從而減輕開發人員在生產過程中可能遇到的持續挫折感。 我們還提供各種教學課程和一系列程式碼範例供您參考，以協助您開始使用IronWord 。

在使用試用許可證測試IronWord的各個方面之後，您可以購買我們的 Lite 開發人員許可證，起價為 599 美元，價格從 Lite 到 Professional 依次遞增。 更多資訊請參閱我們的許可頁面。