UZYWANIE IRONWORD

Jak generowac dokument Word przy uzyciu szablonu Word w C#

Curtis Chau
Curtis Chau
Updated: 8 maja 2026

Wyrównanie tekstu ma kluczowe znaczenie podczas wyświetlania tekstu w aplikacji GUI, takiej jak dokument WORD. Rzeczywiście, istnieje wiele bibliotek, które umożliwiają wyrównywanie tekstu. Pakiet IronWord NuGet okazuje się jednak potężnym narzędziem usprawniającym ten proces, zapewniającym prosty i skuteczny sposób zarządzania formatowaniem lub wyrównaniem w aplikacjach C#. Programiści często stają przed koniecznością wyrównania tekstu na różne sposoby, czy to w raportach, czy w aplikacjach konsolowych - we wszystkich tych przypadkach można z łatwością skorzystać z IronWord NuGet. Przyjrzyjmy się teraz bliżej pakietowi IronWord NuGet oraz temu, jak wyrównać tekst lub akapity za pomocą tego pakietu.

Jak wyrównać tekst w dokumencie Microsoft WORD za pomocą IronWord NuGet

  1. Utwórz nowy projekt w programie Microsoft Visual Studio.
  2. Zainstaluj IronWord za pomocą menedżera pakietów NuGet.
  3. Utwórz dokument WORD z wyrównaniem tekstu.
  4. Zapoznaj się z właściwością wyrównania tekstu w IronWord.

Czym jest IronWord?

IronWord to biblioteka C# NuGet firmy Iron Software, opracowana w celu ułatwienia programowego tworzenia, edycji i zarządzania plikami Microsoft Word. Pozwala to programistom zautomatyzować proces generowania dokumentów WORDa z wyrównanym tekstem, ułatwiając dynamiczne tworzenie raportów, faktur, listów i innych rodzajów dokumentów w ramach ich aplikacji.

Najważniejsze cechy IronWord

1. C# Wyrównanie tekstu w Word

IronWord obsługuje wiele typów wyrównania, w tym wyrównanie tekstu do lewej, prawej, do środka oraz wyjustowane. Ta wszechstronność pozwala programistom wybrać format najlepiej odpowiadający ich konkretnym wymaganiom.

2. Wyrównanie kolumn

Pakiet upraszcza proces wyrównywania tekstu w kolumnach, dzięki czemu jest szczególnie przydatny do generowania raportów lub wyświetlania danych w ustrukturyzowanym formacie.

3. Formatowanie z możliwością dostosowania

IronWord pozwala programistom dostosować szerokość pól tekstowych, zapewniając, że wyrównany tekst idealnie mieści się w określonych granicach.

4. Manipulacja tekstem

W dokumencie programu WORD można łatwo wstawiać, zamieniać lub usuwać tekst.

5. Formatowanie

Biblioteka obsługuje różne opcje formatowania, w tym style nazw czcionek, rozmiary czcionek, kolory i wyrównanie.

6. Tabele i obrazy

IronWord umożliwia wstawianie i edycję tabel oraz obrazów w dokumentach.

7. Kompatybilność

Działa płynnie z różnymi wersjami programu WORD, zapewniając kompatybilność i łatwość użytkowania.

Przykłady zastosowań

  • Generowanie raportów: Automatyczne generowanie szczegółowych raportów z dynamicznymi danymi i wyrównaniem tekstu.
  • Tworzenie faktur: Twórz profesjonalne faktury, wprowadzając dane klienta i transakcji.
  • Zarządzanie umowami: Automatyzacja tworzenia umów zawierających spersonalizowane informacje.
  • Listy i zawiadomienia: Generuj spersonalizowane listy i zawiadomienia dla klientów lub pracowników.

IronWord upraszcza pracę z dokumentami Worda w aplikacjach .NET, co czyni go cennym narzędziem dla programistów, którzy chcą zautomatyzować generowanie dokumentów i zadania związane z zarządzaniem nimi.

Wymagania wstępne

Przed rozpoczęciem pracy prosimy upewnić się, że dysponują Państwo następującymi elementami:

  • Visual Studio jest zainstalowane na Twoim komputerze.
  • Zainstalowano najnowszą wersję .NET Framework.

Krok 1: Utwórz nowy projekt w programie Microsoft Visual Studio

Zacznijmy od utworzenia nowego projektu w Visual Studio.

Wybierz szablon aplikacji konsolowej na poniższym ekranie.

Jak wyrównać tekst w Wordzie przy użyciu C#: Rysunek 2 - Wybór aplikacji konsolowej

Podaj nazwę projektu i lokalizację.

Jak wyrównać tekst w Wordzie przy użyciu C#: Rysunek 3 - Konfiguracja

Wybierz wersję .NET, najlepiej najnowszą z dostępną obsługą, i kliknij Utwórz.

Jak wyrównać tekst w Wordzie przy użyciu C#: Rysunek 4 - Docelowe Framework

Krok 2: Zainstaluj IronWord za pomocą menedżera pakietów NuGet

Zainstaluj pakiet IronWord NuGet z menedżera pakietów NuGet w programie Visual Studio, postępując zgodnie z poniższą instrukcją.

Jak wyrównać tekst w Wordzie przy użyciu C#: Rysunek 5 - Wyszukiwanie IronWord z poziomu Menedżera Pakietów NuGet

Alternatywnie, zainstaluj go bezpośrednio za pomocą CLI, używając poniższego polecenia.

> dotnet add package IronWord --version 2024.9.1

Krok 3: Utwórz dokument WORD z wyrównaniem tekstu

Poniższy przykład kodu pokazuje, jak wygenerować dokument WORDa z tekstem wycentrowanym.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Set your license key for IronWord
        License.LicenseKey = "your key";

        // Create a new document
        var document = new WordDocument();

        // Create a paragraph and add text
        Paragraph paragraph = new Paragraph();
        Text text = new Text() { Text = "IronWord, From IronSoftware" };
        paragraph.AddText(text); // Add text to the paragraph

        // Set text alignment to center aligned
        paragraph.Alignment = IronWord.Models.Enums.TextAlignment.Center;

        // Add the first paragraph to the document
        document.AddParagraph(paragraph);

        // Save the document with the specified filename
        document.SaveAs("output.docx");
    }
}

Wyjaśnienie kodu

  1. Zainicjalizuj nową instancję WordDocument.
  2. Utwórz obiekt tekstowy z żądaną treścią.
  3. Dodaj tekst do akapitu.
  4. Wyrównaj akapit przy użyciu IronWord.Models.Enums.TextAlignment.Center.
  5. Dodaj akapit do instancji WordDocument i zapisz dokument do output.docx.

Wynik

Jak wyrównać tekst w Wordzie przy użyciu C#: Rysunek 7 - Wynik

Krok 4: Zapoznaj się z właściwością wyrównania tekstu w IronWord

Teraz wypróbujmy różne opcje.

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

class Program
{
    static void Main()
    {
        // Set your license key for IronWord
        License.LicenseKey = "your key";

        // Create a new DOCX document
        var doc = new WordDocument();

        // Sample text for alignment
        Text text = new Text() { Text = "IronWord, From IronSoftware" };

        // Add paragraphs with different alignments
        AddPara(doc, text, TextAlignment.Center);
        AddPara(doc, text, TextAlignment.Left);
        AddPara(doc, text, TextAlignment.Right);
        AddPara(doc, text, TextAlignment.Justified);

        // Save the document with all alignment options
        doc.SaveAs("outputAllOptions.docx");
    }

    // Method to add a paragraph to the document with specified alignment
    private static void AddPara(WordDocument doc, Text text, TextAlignment alignment)
    {
        Paragraph paragraph = new Paragraph();
        paragraph.AddText(text);
        paragraph.Alignment = alignment;
        doc.AddParagraph(paragraph);
    }
}

Wyjaśnienie kodu

  1. Zainicjalizuj nową instancję WordDocument.
  2. Utwórz obiekt tekstowy z żądaną treścią.
  3. Dla każdej opcji wyrównania (do środka, do lewej, do prawej, wyjustowane) dodaj tekst do akapitu i ustaw wyrównanie.
  4. Dodaj akapit do instancji WordDocument.
  5. Zapisz dokument ze wszystkimi opcjami wyrównania do outputAllOptions.docx.

Wynik

Jak wyrównać tekst w Wordzie przy użyciu C#: Rysunek 8 - Wynik Wyrównania

Licencjonowanie IronWord

Biblioteka IronWord jest jednym z produktów Iron Suite firmy Iron Software. Do działania wymaga licencji. Użytkownik może pobrać Licencję Trial, używając swojego adresu e-mail na stronie Licencji Trial. Po wprowadzeniu danych licencja zostanie dostarczona na adres e-mail użytkownika. Przed użyciem biblioteki IronWord należy umieścić tę licencję na początku kodu użytkownika, jak pokazano poniżej.

License.LicenseKey = "your Key Here";

Wnioski

Pakiet IronWord NuGet upraszcza proces pracy z dokumentami Worda w aplikacjach .NET. Jego intuicyjny interfejs API pozwala programistom na łatwą manipulację wyrównaniem tekstu i innymi elementami dokumentu. Niezależnie od tego, czy chcesz wyrównać tekst do lewej, do środka, do prawej, czy też wyjustować go, IronWord zapewnia narzędzia potrzebne do tworzenia profesjonalnych i dobrze sformatowanych dokumentów.

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

Czytaj więcej

Powiązane artykuły