Przejdź do treści stopki
UZYWANIE IRONWORD

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"
$vbLabelText   $csharpLabel

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
$vbLabelText   $csharpLabel

VS 2022 Programowe tworzenie nowych dokumentów WORD (samouczek): Rysunek 6 — Wynik z powyższego przykładu

Wyjaśnienie

  1. Najpierw importujemy bibliotekę IronWord i jej modele w przykładowym kodzie.
  2. Tworzymy nową zmienną Text. Ta zmienna pozwala nam dodawać tekst do dokumentu WORD.
  3. Następnie dodajemy textRun do Paragraph. Pozwala nam to na łatwą manipulację tekstem poprzez rozróżnienie między tymi dwoma elementami.
  4. Przekazujemy parametr paragraph do nowej klasy WordDocument w celu utworzenia nowego obiektu dokumentu.
  5. 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
$vbLabelText   $csharpLabel

VS 2022 Programowe tworzenie nowych dokumentów WORD (samouczek): Rysunek 7 — Wynik działania przykładowego kodu powyżej

Wyjaśnienie kodu

  1. Podobnie jak w powyższym przykładzie, tworzymy obiekt Text i dodajemy przykładowy tekst dokumentu.
  2. Następnie tworzymy nowy obiekt TextStyle i przypisujemy właściwość IsItalic jako true, wskazując, że tekst powinien być zapisany kursywą.
  3. To samo robimy dla zmiennej boldText, przypisując true do właściwości IsBold.
  4. Następnie przypisujemy zmienne TextStyle do odpowiednich zmiennych Text.
  5. Tworzymy zmienną Paragraph i wywołujemy metodę AddText, aby dodać tekst pisany kursywą i pogrubiony.
  6. Dodajemy akapit do dokumentu, używając metody AddParagraph.
  7. 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

VS 2022 Programowe tworzenie nowych dokumentów WORD (samouczek): Rysunek 8 — Informacje o licencji IronWord

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.

Jordi Bardia
Inżynier oprogramowania
Jordi jest najbardziej biegły w Pythonie, C# i C++. Kiedy nie wykorzystuje swoich umiejętności w Iron Software, programuje gry. Dzieląc odpowiedzialność za testowanie produktów, rozwój produktów i badania, Jordi wnosi ogromną wartość do ciągłej poprawy produktów. Różnorodne doświadczenia ...
Czytaj więcej

Zespol wsparcia Iron

Jestesmy online 24 godziny, 5 dni w tygodniu.
Czat
Email
Zadzwon do mnie