VS 2022 Programistyczne tworzenie nowych dokumentów Word (samouczek)
W erze cyfrowej dokumenty coraz częściej przyjmują formę cyfrową. Dokumenty w środowisku biznesowym często kojarzą się z programem WORD i plikami WORDa. Tworzenie i edycja dokumentów w programie WORD stało się podstawą przekazywania informacji w dużych organizacjach. Jednak ręczne tworzenie i edytowanie dokumentów może być uciążliwym procesem; Automatyczne generowanie dokumentów WORDa za pomocą kodu również nie jest łatwym zadaniem, ponieważ wiele bibliotek open source opiera się na Microsoft Office WORD jako bibliotece zależności.
Jednak zarządzanie dokumentami WORD i ich tworzenie nie musi być aż tak trudne. Biblioteka IronWord to biblioteka C# dla programu Word, która nie jest zależna od pakietu Microsoft Office Word i pozwala użytkownikom dostosowywać cały dokument, a także generować dokumenty i tworzyć szablony dokumentów programowo.
W dzisiejszym samouczku pokażę, jak programowo stworzyć dokument Microsoft WORD za pomocą IronWord, i podam krótkie przykłady.
IronWord: biblioteka C# dla programu Word
IronWord to wyjątkowo niezawodna i przyjazna dla użytkownika biblioteka C# Docx, która umożliwia programistom tworzenie i modyfikowanie dokumentów Worda przy użyciu języka C#, bez konieczności korzystania z tradycyjnych zależności, takich jak Microsoft Office czy Word Interop. Ponadto oferuje obszerną dokumentację i zapewnia pełną obsługę platform .NET 8, 7, 6, Framework, Core oraz Azure, dzięki czemu jest uniwersalnie kompatybilna z większością aplikacji. Ten poziom elastyczności sprawia, że jest to doskonały wybór dla każdej aplikacji, z którą masz do czynienia.
Konfiguracja środowiska
W tym przykładzie stworzymy aplikację konsolową przy użyciu Visual Studio i pokażemy, jak tworzyć puste dokumenty WORDa oraz jak nimi manipulować za pomocą biblioteki IronWord. Zanim przejdziemy do kolejnego kroku, upewnij się, że masz zainstalowane Visual Studio.
Najpierw utwórzmy nową aplikację konsolową.
Następnie podaj nazwę projektu i zapisz lokalizację, jak pokazano poniżej.
Na koniec wybierz żądany framework.
Instalacja biblioteki C# WORD
Po utworzeniu pustej aplikacji konsolowej pobierzemy IronWord za pomocą menedżera pakietów NuGet.
Kliknij "Zarządzaj pakietami NuGet", a następnie wyszukaj IronWord w zakładce "Przeglądaj", jak pokazano poniżej.
Następnie zainstaluj go w nowo utworzonym projekcie.
Alternatywnie można wpisać następujące polecenie w wierszu poleceń, aby zainstalować IronWord.
Install-Package IronWord
Teraz, gdy wszystko jest już skonfigurowane i gotowe do działania, przejdźmy do przykładu tworzenia dokumentów WORD.
Klucz licencyjny
Należy pamiętać, że do działania programu IronWord wymagańy jest klucz licencyjny. Klucz można uzyskać w ramach bezpłatnej wersji próbnej, odwiedzając ten link.
// 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"
Po otrzymaniu klucza próbnego ustaw tę zmienną w swoim projekcie.
Tworzenie nowego dokumentu WORD
using IronWord;
using IronWord.Models;
class Program
{
static void Main()
{
// Create a textrun
Text textRun = new Text("Sample text");
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
// Create a new Word document with the paragraph
WordDocument doc = new WordDocument(paragraph);
// Export docx
doc.SaveAs("document.docx");
}
}
using IronWord;
using IronWord.Models;
class Program
{
static void Main()
{
// Create a textrun
Text textRun = new Text("Sample text");
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
// Create a new Word document with the paragraph
WordDocument doc = new WordDocument(paragraph);
// Export docx
doc.SaveAs("document.docx");
}
}
Imports IronWord
Imports IronWord.Models
Friend Class Program
Shared Sub Main()
' Create a textrun
Dim textRun As New Text("Sample text")
Dim paragraph As New Paragraph()
paragraph.AddChild(textRun)
' Create a new Word document with the paragraph
Dim doc As New WordDocument(paragraph)
' Export docx
doc.SaveAs("document.docx")
End Sub
End Class

Wyjaśnienie
- Najpierw importujemy bibliotekę IronWord i jej modele w przykładowym kodzie.
- Tworzymy nową zmienną
Text. Ta zmienna pozwala nam dodawać tekst do dokumentu WORD. - Następnie dodajemy
textRundoParagraph. Pozwala nam to na łatwą manipulację tekstem poprzez rozróżnienie między tymi dwoma elementami. - Przekazujemy parametr
paragraphdo nowej klasyWordDocumentw celu utworzenia nowego obiektu dokumentu. - Na koniec zapisujemy dokument jako "document.docx" w formacie WORD.
W poprzednim przykładzie utworzyliśmy dokument WORDa zawierający podstawowy tekst. Zróbmy przykład z bardziej zaawansowanymi funkcjami, takimi jak dostosowywanie tekstu i dodawanie efektów tekstowych.
using IronWord;
using IronWord.Models;
class Program
{
static void Main()
{
// Ensure to set up the license key
IronWord.License.LicenseKey = "YOUR-KEY";
// Load an existing docx
WordDocument doc = new WordDocument("document.docx");
// Create sample texts with styles
Text introText = new Text("This is an example paragraph with italic and bold styling.");
TextStyle italicStyle = new TextStyle()
{
IsItalic = true
};
Text italicText = new Text("Italic example sentence.");
italicText.Style = italicStyle;
TextStyle boldStyle = new TextStyle()
{
IsBold = true
};
Text boldText = new Text("Bold example sentence.");
boldText.Style = boldStyle;
// Create a paragraph and add texts
Paragraph paragraph = new Paragraph();
paragraph.AddText(introText);
paragraph.AddText(italicText);
paragraph.AddText(boldText);
// Add paragraph to the document
doc.AddParagraph(paragraph);
// Export the document
doc.SaveAs("save_document.docx");
}
}
using IronWord;
using IronWord.Models;
class Program
{
static void Main()
{
// Ensure to set up the license key
IronWord.License.LicenseKey = "YOUR-KEY";
// Load an existing docx
WordDocument doc = new WordDocument("document.docx");
// Create sample texts with styles
Text introText = new Text("This is an example paragraph with italic and bold styling.");
TextStyle italicStyle = new TextStyle()
{
IsItalic = true
};
Text italicText = new Text("Italic example sentence.");
italicText.Style = italicStyle;
TextStyle boldStyle = new TextStyle()
{
IsBold = true
};
Text boldText = new Text("Bold example sentence.");
boldText.Style = boldStyle;
// Create a paragraph and add texts
Paragraph paragraph = new Paragraph();
paragraph.AddText(introText);
paragraph.AddText(italicText);
paragraph.AddText(boldText);
// Add paragraph to the document
doc.AddParagraph(paragraph);
// Export the document
doc.SaveAs("save_document.docx");
}
}
Imports IronWord
Imports IronWord.Models
Friend Class Program
Shared Sub Main()
' Ensure to set up the license key
IronWord.License.LicenseKey = "YOUR-KEY"
' Load an existing docx
Dim doc As New WordDocument("document.docx")
' Create sample texts with styles
Dim introText As New Text("This is an example paragraph with italic and bold styling.")
Dim italicStyle As New TextStyle() With {.IsItalic = True}
Dim italicText As New Text("Italic example sentence.")
italicText.Style = italicStyle
Dim boldStyle As New TextStyle() With {.IsBold = True}
Dim boldText As New Text("Bold example sentence.")
boldText.Style = boldStyle
' Create a paragraph and add texts
Dim paragraph As New Paragraph()
paragraph.AddText(introText)
paragraph.AddText(italicText)
paragraph.AddText(boldText)
' Add paragraph to the document
doc.AddParagraph(paragraph)
' Export the document
doc.SaveAs("save_document.docx")
End Sub
End Class

Wyjaśnienie kodu
- Podobnie jak w powyższym przykładzie, tworzymy obiekt
Texti dodajemy przykładowy tekst dokumentu. - Następnie tworzymy nowy obiekt
TextStylei przypisujemy właściwośćIsItalicjakotrue, wskazując, że tekst powinien być zapisany kursywą. - To samo robimy dla zmiennej
boldText, przypisująctruedo właściwościIsBold. - Następnie przypisujemy zmienne
TextStyledo odpowiednich zmiennychText. - Tworzymy zmienną
Paragraphi wywołujemy metodęAddText, aby dodać tekst pisany kursywą i pogrubiony. - Dodajemy akapit do dokumentu, używając metody
AddParagraph. - Na koniec zapisujemy dokument jako "save_document.docx".
Powyższy przykład pokazuje czcionki i style, z których programiści mogą korzystać za pomocą IronWord. Oprócz efektów kursywy i pogrubienia tekstu, IronWord oferuje również inne funkcje, aby zapewnić programistom wszystkie opcje tworzenia unikalnych dokumentów WORD w różnych scenariuszach.
Wnioski

Nasze prezentacje pokazały, jak łatwo jest używać biblioteki IronWord do programowego tworzenia dokumentów Worda w języku C#. Elastyczność i skalowalność biblioteki sprawiają, że jest ona cennym narzędziem dla programistów w rzeczywistych sytuacjach, takich jak dostosowywanie tekstu, czcionki i stylu w dokumencie WORD. Zrozumienie, w jaki sposób WORD integruje się z innymi aplikacjami, zapewnia programistom dodatkowe rozwiązania dla ich wyzwań.
IronWord oferuje bezpłatną licencję próbną.
Często Zadawane Pytania
Jak mogę programowo utworzyć dokument WORD w języku C#?
Możesz programowo utworzyć dokument Microsoft Word w języku C#, korzystając z biblioteki IronWord. Zainicjuj obiekt WordDocument, dodaj niezbędną treść i użyj metody SaveAs, aby wyeksportować go jako plik .docx.
Jakie są zalety korzystania z IronWord zamiast Microsoft Office Interop do tworzenia dokumentów WORD?
IronWord oferuje przewagę nad Microsoft Office Interop, ponieważ nie wymaga instalacji pakietu Microsoft Office, zapewniając większą elastyczność i łatwiejszą integrację na różnych platformach bez zależności od Office.
Jak zainstalować IronWord w Visual Studio?
Aby zainstalować IronWord w Visual Studio, otwórz menedżera pakietów NuGet, wyszukaj IronWord i zainstaluj go w swoim projekcie. Alternatywnie możesz użyć wiersza poleceń z poleceniem Install-Package IronWord.
Czy mogę formatować tekst w dokumencie WORD za pomocą IronWord?
Tak, w dokumencie WORD można formatować tekst za pomocą IronWord, wykorzystując obiekt TextStyle do stosowania różnych stylów, takich jak kursywa i pogrubienie, do elementów tekstowych.
Czy IronWord jest kompatybilny z .NET i Azure?
Tak, IronWord jest w pełni kompatybilny z .NET 8, 7, 6, Framework, Core i Azure, co sprawia, że jest wszechstronny w różnych zastosowaniach.
Jak mogę rozwiązać problemy z instalacją IronWord?
Jeśli napotkasz problemy z instalacją IronWord, upewnij się, że używasz kompatybilnej wersji Visual Studio i .NET oraz że menedżer pakietów NuGet jest zaktualizowany. Sprawdź połączenie internetowe i ponów próbę instalacji.
Co jest potrzebne, aby rozpocząć tworzenie dokumentów WORD za pomocą IronWord?
Aby rozpocząć tworzenie dokumentów Worda za pomocą IronWord, zaimportuj bibliotekę IronWord i jej modele do swojego projektu C#. Następnie zainicjuj obiekt WordDocument, aby rozpocząć tworzenie dokumentu.
Jak mogę programowo dodawać akapity do dokumentu WORD za pomocą IronWord?
Możesz programowo dodawać akapity do dokumentu WORDa za pomocą IronWord, tworząc obiekty Paragraph, dodając do nich tekst i umieszczając je w WordDocument.




