信息圖標
跳過到頁腳內容
  1. IronWord
  2. IronWord 博客
  3. 使用 IronWord
  4. C# 編輯 Word
使用 IRONWORD

C# 編輯 Word（代碼示例開發者教程）

Jordi Bardia
Jordi Bardia
更新日期:

Creating, editing, and managing Word documents is a frequent requirement for many applications. While there are several ways to create and edit a Word document in C#, one of the most powerful methods is using the Microsoft Interop services. With this tool, you can handle Word documents programmatically with much ease.

Edit Word and DOCX Documents

  1. Download the C# library to edit Word and DOCX documents
  2. Create an empty Word document in code
  3. Add a new text to the Word document
  4. Edit the text in a new or existing document
  5. Export the DOCX files to desired location

Prerequisites

Before setting up the environment and starting with the code, ensure you meet the following prerequisites:

  1. Visual Studio: Ensure you have Visual Studio installed on your machine. If not, download and install it from the official Microsoft website.
  2. Microsoft Word: Since we're using Microsoft Interop, you should have MS Word installed on your computer. The Interop service interfaces with the Microsoft Word application installed on your machine.
  3. Basic C# Knowledge: Understanding basic C# concepts is essential.
  4. .NET Framework: Ensure your Visual Studio supports the .NET Framework since our application will be based on it.

Setting up the Environment

Start by opening the Visual Studio application. Once open, you'll be greeted with a welcome screen.

1. Create a New .NET Framework Console Application

  1. Click on "Create a new project".
  2. Type "Console App (.NET Framework)" in the search box.
  3. From the results, select "Console App (.NET Framework)" and click on the "Next" button.
  4. Set a name for your project, then click the "Create" button.

After these steps, Visual Studio will generate a new .NET Framework console application for you. In the Program.cs file, you will find a basic template with a Main method, which is the entry point for console applications.

2. Install Microsoft.Office.Interop.Word using NuGet Package Manager

NuGet is a package manager for .NET, and it's integrated into Visual Studio. Here's how you can use it to install the Microsoft.Office.Interop.Word package:

  1. In Visual Studio, go to the "Tools" menu.
  2. Select "NuGet Package Manager" and then "Manage NuGet Packages for Solution...".
  3. In the NuGet window, click on the "Browse" tab.
  4. In the search box, type Microsoft.Office.Interop.Word and hit enter.
  5. From the search results, select the Microsoft.Office.Interop.Word package.
  6. On the right side, ensure your console application project is checked, then click on the "Install" button.

C# Edit Word (Code Example Developer Tutorial) Figure 1

Visual Studio will now install the package and add a reference to it in your project. This package contains the necessary assemblies and tools to interact with MS Word from your C# application.

Introducing IronWord: A Superior Alternative to Interop

While Interop provides powerful capabilities for working with Word and Excel, it has limitations. Enter IronWord, a versatile library optimized for .NET developers. IronWord offers a smoother experience than Interop, especially for editing Word document tasks. It not only ensures compatibility and performance but also simplifies complex tasks with intuitive methods. For ease of comparison, I will provide IronWord code snippets for each use case after MS Word, using IronWord version 2024.1.2.

Opening an Existing Word Document

Often, you may need to edit existing Word documents, the following example shows how to do this in C#:

// Create an instance of the Word Application
var WordApp = new Microsoft.Office.Interop.Word.Application();

// Open a Word document with the specified file path
var WordDoc = WordApp.Documents.Open(@"path_to_your_document.docx");
// Create an instance of the Word Application
var WordApp = new Microsoft.Office.Interop.Word.Application();

// Open a Word document with the specified file path
var WordDoc = WordApp.Documents.Open(@"path_to_your_document.docx");
' Create an instance of the Word Application
Dim WordApp = New Microsoft.Office.Interop.Word.Application()

' Open a Word document with the specified file path
Dim WordDoc = WordApp.Documents.Open("path_to_your_document.docx")
$vbLabelText   $csharpLabel

In the above code, replace path_to_your_document.docx with the path to your docx file.

Using IronWord

Open a Word document using IronWord.

// Open a Word document with the specified file path using IronWord
WordDocument doc = new WordDocument(@"path_to_your_document.docx");
// Open a Word document with the specified file path using IronWord
WordDocument doc = new WordDocument(@"path_to_your_document.docx");
' Open a Word document with the specified file path using IronWord
Dim doc As New WordDocument("path_to_your_document.docx")
$vbLabelText   $csharpLabel

Creating a New Word Document

To create Word documents from scratch:

// Initialize a new instance of the Word Application
var WordApp = new Microsoft.Office.Interop.Word.Application();

// Add a new Word document
var WordDoc = WordApp.Documents.Add();
// Initialize a new instance of the Word Application
var WordApp = new Microsoft.Office.Interop.Word.Application();

// Add a new Word document
var WordDoc = WordApp.Documents.Add();
' Initialize a new instance of the Word Application
Dim WordApp = New Microsoft.Office.Interop.Word.Application()

' Add a new Word document
Dim WordDoc = WordApp.Documents.Add()
$vbLabelText   $csharpLabel

This code snippet creates a new Word Document you can write and edit using C#.

Using IronWord

// Create a new, empty Word document using IronWord
WordDocument doc = new WordDocument();
// Create a new, empty Word document using IronWord
WordDocument doc = new WordDocument();
' Create a new, empty Word document using IronWord
Dim doc As New WordDocument()
$vbLabelText   $csharpLabel

Adding Text to the Word Document

To add a new paragraph of text:

// Add a new paragraph to the document
WordDoc.Paragraphs.Add();
// Assign text to the newly added paragraph
WordDoc.Paragraphs[1].Range.Text = "This is the first paragraph.";
// Add a new paragraph to the document
WordDoc.Paragraphs.Add();
// Assign text to the newly added paragraph
WordDoc.Paragraphs[1].Range.Text = "This is the first paragraph.";
' Add a new paragraph to the document
WordDoc.Paragraphs.Add()
' Assign text to the newly added paragraph
WordDoc.Paragraphs(1).Range.Text = "This is the first paragraph."
$vbLabelText   $csharpLabel

The Paragraphs.Add() method adds a new paragraph to the Word document and the Range.Text property assigns new text to it.

Using IronWord

// Add a new text to the document using IronWord
doc.AddText("Add text using IronWord");
// Add a new text to the document using IronWord
doc.AddText("Add text using IronWord");
' Add a new text to the document using IronWord
doc.AddText("Add text using IronWord")
$vbLabelText   $csharpLabel

Editing Existing Text

For this tutorial, let's change the first paragraph:

// Edit the text of the first paragraph
WordDoc.Paragraphs[1].Range.Text = "This is the edited first paragraph.";
// Edit the text of the first paragraph
WordDoc.Paragraphs[1].Range.Text = "This is the edited first paragraph.";
' Edit the text of the first paragraph
WordDoc.Paragraphs(1).Range.Text = "This is the edited first paragraph."
$vbLabelText   $csharpLabel

You can also add and edit other elements in the Word document using similar methods.

Using IronWord

// Edit the text of the first paragraph using IronWord
doc.Paragraphs[0].TextRuns[0].Text = "This is the edited first paragraph.";
// Edit the text of the first paragraph using IronWord
doc.Paragraphs[0].TextRuns[0].Text = "This is the edited first paragraph.";
' Edit the text of the first paragraph using IronWord
doc.Paragraphs(0).TextRuns(0).Text = "This is the edited first paragraph."
$vbLabelText   $csharpLabel

Saving and Closing the Document

Once you've made your desired edits:

// Save the document to a specified path
WordDoc.SaveAs(@"path_where_you_want_to_save.docx");
// Close the document and quit the application
WordDoc.Close();
WordApp.Quit();
// Save the document to a specified path
WordDoc.SaveAs(@"path_where_you_want_to_save.docx");
// Close the document and quit the application
WordDoc.Close();
WordApp.Quit();
' Save the document to a specified path
WordDoc.SaveAs("path_where_you_want_to_save.docx")
' Close the document and quit the application
WordDoc.Close()
WordApp.Quit()
$vbLabelText   $csharpLabel

Replace path_where_you_want_to_save.docx with your desired path.

Using IronWord

// Save the document to the desired path using IronWord
doc.SaveAs(@"path_where_you_want_to_save.docx");
// Save the document to the desired path using IronWord
doc.SaveAs(@"path_where_you_want_to_save.docx");
' Save the document to the desired path using IronWord
doc.SaveAs("path_where_you_want_to_save.docx")
$vbLabelText   $csharpLabel

Complete Code and Example

Let's put it all together. Here's a complete code example demonstrating how to open an existing Word document, edit it, and then save the changes:

var WordApp = new Microsoft.Office.Interop.Word.Application();

// Create a new Word document
var WordDoc = WordApp.Documents.Add();

// Add new text
WordDoc.Paragraphs.Add();
WordDoc.Paragraphs[1].Range.Text = "This is the first paragraph.";

// Edit the first paragraph
WordDoc.Paragraphs[1].Range.Text = "This is the edited first paragraph.";

// Save and close
WordDoc.SaveAs(@"path_where_you_want_to_save.docx");
WordDoc.Close();
WordApp.Quit();
var WordApp = new Microsoft.Office.Interop.Word.Application();

// Create a new Word document
var WordDoc = WordApp.Documents.Add();

// Add new text
WordDoc.Paragraphs.Add();
WordDoc.Paragraphs[1].Range.Text = "This is the first paragraph.";

// Edit the first paragraph
WordDoc.Paragraphs[1].Range.Text = "This is the edited first paragraph.";

// Save and close
WordDoc.SaveAs(@"path_where_you_want_to_save.docx");
WordDoc.Close();
WordApp.Quit();
Dim WordApp = New Microsoft.Office.Interop.Word.Application()

' Create a new Word document
Dim WordDoc = WordApp.Documents.Add()

' Add new text
WordDoc.Paragraphs.Add()
WordDoc.Paragraphs(1).Range.Text = "This is the first paragraph."

' Edit the first paragraph
WordDoc.Paragraphs(1).Range.Text = "This is the edited first paragraph."

' Save and close
WordDoc.SaveAs("path_where_you_want_to_save.docx")
WordDoc.Close()
WordApp.Quit()
$vbLabelText   $csharpLabel

Using IronWord

The complete code example using IronWord is concise. IronWord utilizes concise code snippets to edit DOCX files.

// Create an empty Word document
WordDocument doc = new WordDocument();

// Add new text
doc.AddText("This is the first paragraph.");

// Edit the text
doc.Paragraphs[0].TextRuns[0].Text = "This is the edited first paragraph.";

// Export DOCX
doc.SaveAs(@"path_where_you_want_to_save.docx");
// Create an empty Word document
WordDocument doc = new WordDocument();

// Add new text
doc.AddText("This is the first paragraph.");

// Edit the text
doc.Paragraphs[0].TextRuns[0].Text = "This is the edited first paragraph.";

// Export DOCX
doc.SaveAs(@"path_where_you_want_to_save.docx");
' Create an empty Word document
Dim doc As New WordDocument()

' Add new text
doc.AddText("This is the first paragraph.")

' Edit the text
doc.Paragraphs(0).TextRuns(0).Text = "This is the edited first paragraph."

' Export DOCX
doc.SaveAs("path_where_you_want_to_save.docx")
$vbLabelText   $csharpLabel

Conclusion

In the realm of manipulating Word and Excel documents within .NET applications, choices abound. While Microsoft's Interop services have been a go-to for many, the emergence of solutions like IronWord signifies a shift towards more efficient and user-friendly tools.

常見問題解答

如何在 C# 中創建和編輯 Word 文檔？

您可以使用 Microsoft Interop 服務或 IronWord 庫在 C# 中創建和編輯 Word 文檔。這兩種選擇都允許您以編程方式操作 Word 文檔，而 IronWord 提供了更高的性能和更簡單的使用方法。

使用 IronWord 而非 Microsoft Interop 操作 Word 文檔有何好處？

IronWord 比 Microsoft Interop 提供了更流暢的體驗，因為它提供了更好的性能和更直觀的方法來編輯 Word 文檔。它針對 .NET 應用程序進行了優化，使其成為開發人員的現代高效選擇。

如何使用 C# 打開現有的 Word 文檔？

要使用 C# 打開現有的 Word 文檔，您可以使用 Microsoft Interop 服務或 IronWord 等庫。它們提供方法以編程方式加載和操控 Word 文件的內容。

設置 .NET Framework 控制台應用程序以編輯 Word 文檔需要哪些步驟？

首先，確保您安裝了 Visual Studio 和 .NET Framework。 在 Visual Studio 中創建新的 .NET Framework 控制台應用程序，並使用 NuGet 包管理器安裝 Microsoft.Office.Interop.Word 包或 IronWord 庫。

如何使用 C# 向 Word 文檔添加文本？

您可以使用 Microsoft Interop 或 IronWord 之類的庫來向 Word 文檔添加文本。這些庫提供方法來以編程方式插入和修改文檔中的文本。

如何在 C# 中保存和關閉 Word 文檔？

在 C# 中，您可以使用 Microsoft Interop 或 IronWord 等庫提供的方法來保存和關閉 Word 文檔。這些方法確保更改已保存且文檔正確關閉。

在 Visual Studio 中安裝 Microsoft.Office.Interop.Word 包的過程是什麼？

要在 Visual Studio 中安裝 Microsoft.Office.Interop.Word 包，通過“工具”菜單進入 NuGet 包管理器，選擇“為方案管理 NuGet 包...”，搜索“Microsoft.Office.Interop.Word”，然後安裝該包。

如何故障排除使用 C# 編輯 Word 文檔時的常見錯誤？

使用 C# 編輯 Word 文檔時的常見錯誤通常可以通過檢查正確的庫安裝、確保與 .NET Framework 的兼容性以及驗證文檔路徑和權限是否正確來解決。

如何在 C# 中創建一個新的 Word 文檔？

您可以使用 Microsoft Interop 或 IronWord 等庫在 C# 中創建新的 Word 文檔。這些庫提供方法來初始化新的 Word 文檔並根據需要添加內容。

IronWord 是否有完整的編輯 Word 文檔的代碼範例？

是的，教程提供了使用 IronWord 編輯 Word 文檔的完整代碼範例。它包括創建 Word 應用程序實例、添加和編輯文本以及保存文檔，演示了 IronWord 方法的實際應用。

Jordi Bardia
Jordi Bardia
  立即與工程團隊聊天
軟體工程師
Jordi 在 Python、C# 和 C++ 上最得心應手，當他不在 Iron Software 展現技術時，便在做遊戲編程。在分担产品测测试，产品开发和研究的责任时，Jordi 为持续的产品改进增值。他说这种多样化的经验使他受到挑战并保持参与, 而这也是他与 Iron Software 中工作一大乐趣。Jordi 在佛罗里达州迈阿密长大，曾在佛罗里达大学学习计算机科学和统计学。

相關文章

30 天試用→完整產品。無限制。無需信用卡。 開始免費試用