Tworzenie, edycja i zarządzanie dokumentami WORDa to częste wymagania wielu aplikacji. Chociaż istnieje kilka sposobów tworzenia i edycji dokumentów WORDa w języku C#, jedną z najskuteczniejszych metod jest wykorzystanie usług Microsoft Interop. Dzięki temu narzędziu można z łatwością obsługiwać dokumenty WORDa programowo.

Wymagania wstępne

Przed skonfigurowaniem środowiska i rozpoczęciem pracy z kodem upewnij się, że spełniasz następujące wymagania wstępne:

1. Visual Studio: Upewnij się, że masz zainstalowane Visual Studio na swoim komputerze. Jeśli nie, pobierz i zainstaluj je z oficjalnej strony Microsoftu.
2. Microsoft WORD: Ponieważ korzystamy z Microsoft Interop, na komputerze powinno być zainstalowane oprogramowanie MS WORD. Usługa Interop współpracuje z aplikacją WORD zainstalowaną na komputerze użytkownika.
3. Podstawowa znajomość języka C#: Niezbędne jest zrozumienie podstawowych pojęć języka C#.
4. .NET Framework: Upewnij się, że Twoje Visual Studio obsługuje .NET Framework, ponieważ nasza aplikacja będzie na nim oparta.

Konfiguracja środowiska

Zacznij od otwarcia aplikacji Visual Studio. Po otwarciu pojawi się ekran powitalny.

1. Utwórz nową aplikację konsolową .NET Framework

1. Kliknij "Utwórz nowy projekt".
2. Wpisz "Console App (.NET Framework)" w polu wyszukiwania.
3. Z wyników wybierz "Aplikacja konsolowa (.NET Framework)" i kliknij przycisk "Dalej".
4. Nadaj nazwę swojemu projektowi, a następnie kliknij przycisk "Utwórz".

Po wykonaniu tych kroków Visual Studio wygeneruje dla Ciebie nową aplikację konsolową .NET Framework. W pliku Program.cs znajdziesz podstawowy szablon z metoda Main, która jest punktem wejściowym dla aplikacji konsolowych.

2. Zainstaluj Microsoft.Office.Interop.Word za pomocą Menedżera Pakietów NuGet

NuGet to menedżer pakietów dla platformy .NET, zintegrowany z programem Visual Studio. Oto, jak możesz go użyć do zainstalowania pakietu Microsoft.Office.Interop.Word:

1. W programie Visual Studio przejdź do menu "Narzędzia".
2. Wybierz "Menedżer pakietów NuGet", a następnie "Zarządzaj pakietami NuGet dla rozwiązania...".
3. W oknie NuGet kliknij kartę "Przeglądaj".
4. W polu wyszukiwania wpisz Microsoft.Office.Interop.Word i naciśnij enter.
5. Z wyników wyszukiwania wybierz pakiet Microsoft.Office.Interop.Word.
6. Po prawej stronie upewnij się, że projekt aplikacji konsolowej jest zaznaczony, a następnie kliknij przycisk "Zainstaluj".

Visual Studio zainstaluje teraz pakiet i doda do niego odwołanie w projekcie. Ten pakiet zawiera niezbędne moduły i narzędzia do interakcji z programem MS WORD z poziomu aplikacji napisanej w języku C#.

Przedstawiamy IronWord: doskonałą alternatywę dla Interop

Chociaż Interop zapewnia zaawansowane możliwości pracy z programami WORD i Excel, ma pewne ograniczenia. Poznaj bibliotekę IronWord, wszechstronną bibliotekę zoptymalizowaną dla programistów .NET. IronWord zapewnia płynniejsze działanie niż Interop, zwłaszcza podczas edycji dokumentów WORD. Zapewnia to nie tylko kompatybilność i wydajność, ale także upraszcza złożone zadania dzięki intuicyjnym metodom. Aby ułatwić porównanie, podam fragmenty kodu IronWord dla każdego przypadku użycia po MS WORD, korzystając z IronWord w wersji 2024.1.2.

Otwieranie istniejącego dokumentu WORD

Często może zaistnieć potrzeba edycji istniejących dokumentów WORDa. Poniższy przykład pokazuje, jak to zrobić w języku 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")

' 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")

W powyższym kodzie zamień path_to_your_document.docx na ścieżkę do swojego pliku docx.

Korzystanie z IronWord

Otwórz dokument WORDa za pomocą 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")

' Open a Word document with the specified file path using IronWord
Dim doc As New WordDocument("path_to_your_document.docx")

Tworzenie nowego dokumentu WORD

Aby utworzyć dokumenty WORD od podstaw:

// 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()

' 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()

Ten fragment kodu tworzy nowy dokument WORDa, który można edytować za pomocą języka C#.

Korzystanie z 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()

' Create a new, empty Word document using IronWord
Dim doc As New WordDocument()

Dodawanie tekstu do dokumentu WORD

Aby dodać nowy akapit tekstu:

// 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."

' 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."

Metoda Paragraphs.Add() dodaje nowy akapit do dokumentu Word, a właściwość Range.Text przypisuje mu nowy tekst.

Korzystanie z 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")

' Add a new text to the document using IronWord
doc.AddText("Add text using IronWord")

Edycja istniejącego tekstu

W tym samouczku zmieńmy pierwszy akapit:

// 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."

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

Możesz również dodawać i edytować inne elementy w dokumencie WORDa, korzystając z podobnych metod.

Korzystanie z 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."

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

Zapisywanie i zamykanie dokumentu

Po wprowadzeniu żądanych zmian:

// 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()

' 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()

Zamień path_where_you_want_to_save.docx na swoją żądaną ścieżkę.

Korzystanie z 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")

' Save the document to the desired path using IronWord
doc.SaveAs("path_where_you_want_to_save.docx")

Pełny kod i przykład

Zbierzmy to wszystko w całość. Oto kompletny przykład kodu pokazujący, jak otworzyć istniejący dokument WORD, edytować go, a następnie zapisać zmiany:

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()

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()

Korzystanie z IronWord

Pełny przykład kodu wykorzystujący IronWord jest zwięzły. IronWord wykorzystuje zwięzłe fragmenty kodu do edycji plików 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
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")

' 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")

Wnioski

W dziedzinie manipulowania dokumentami WORD i Excel w aplikacjach .NET istnieje wiele możliwości. Chociaż usługi Interop firmy Microsoft były dotychczas wybierane przez wielu, pojawienie się rozwiązań takich jak IronWord oznacza przejście w kierunku bardziej wydajnych i przyjaznych dla użytkownika narzędzi.