Pierwsze kroki z IronWord

IronWord: Biblioteka dokumentów Word dla .NET

IronWord to biblioteka dokumentów Word opracowana przez Iron Software. IronWord wyróżnia się wszechstronną funkcjonalnością pracy z dokumentami Word w aplikacjach .NET.

• Wczytywanie, modyfikowanie i zapisywanie dokumentów Word i Docx.
• PageSetup: Konfigurowanie rozmiaru papieru, orientacji strony, marginesów i koloru tła.
• TextRun: Obsługa treści tekstowej, stylów, podziału, dołączania tekstu i dodawania obrazów.
• TextStyle: Zarządzanie rodziną czcionek, rozmiarem, kolorem, pogrubieniem, kursywą, przekreśleniem, podkreśleniem, indeksem górnym i dolnym.
• Paragraph: Dodawanie przebiegów tekstu, obrazów, kształtów, ustawianie stylów, wyrównań, punktorów i list numerowanych.
• Table: Modyfikowanie struktury tabeli, w tym dodawanie wierszy, pobieranie i ustawianie wartości komórek, usuwanie wierszy, scalanie komórek i inne.
• Image: Wczytywanie obrazów z plików lub strumieni, ustawianie zawijania tekstu, przesunięcia pozycji, szerokości, wysokości i innych właściwości.
• Shape: Ustawianie zawijania tekstu, przesunięcia pozycji, szerokości, wysokości, typu kształtu i obrotu.

Instalacja

Install-Package IronWord

Stosowanie klucza licencyjnego

Następnie należy zastosować ważną licencję lub klucz próbny dla IronWord, przypisując klucz licencyjny do właściwości LicenseKey klasy License. Należy umieścić poniższy kod zaraz po instrukcji importu, przed użyciem jakichkolwiek metod IronWord:

using IronWord;

// Przypisz klucz licencyjny
License.LicenseKey = "YOUR_LICENSE_KEY_HERE";

using IronWord;

// Przypisz klucz licencyjny
License.LicenseKey = "YOUR_LICENSE_KEY_HERE";

Imports IronWord

' Przypisz klucz licencyjny
License.LicenseKey = "YOUR_LICENSE_KEY_HERE"

Przykłady kodu

Zapoznajmy się z przykładami kodu i dostępnymi funkcjami.

1. Wybierz „Plik" > „Informacje" i kliknij „Konwertuj".
2. Zostanie wyświetlony komunikat informujący o aktualizacji dokumentu do najnowszego formatu pliku. Kliknij „OK".

Tworzenie dokumentu Word i Docx

Dokument Word tworzy się przez utworzenie instancji klasy WordDocument przy użyciu jednego z jej konstruktorów. Następnie należy użyć metody SaveAs, aby wyeksportować dokument Word. Przykład:

using IronWord;

class Program
{
    static void Main()
    {
        // Utwórz nowy dokument Word
        var document = new WordDocument();

        // Zapisz dokument jako plik .docx
        document.SaveAs("example.docx");
    }
}

using IronWord;

class Program
{
    static void Main()
    {
        // Utwórz nowy dokument Word
        var document = new WordDocument();

        // Zapisz dokument jako plik .docx
        document.SaveAs("example.docx");
    }
}

Imports IronWord

Class Program
    Shared Sub Main()
        ' Utwórz nowy dokument Word
        Dim document As New WordDocument()

        ' Zapisz dokument jako plik .docx
        document.SaveAs("example.docx")
    End Sub
End Class

Dodawanie obrazu

Obrazu nie można dodać samodzielnie — należy go dodać do jednej ze struktur dokumentu, takich jak Paragraph, TableCell lub Section. Do dodawania obrazu służy metoda AddImage. Przykład:

using IronWord;
using System.Drawing;

class Program
{
    static void Main()
    {
        var document = new WordDocument();
        var section = document.Sections.Add();

        // Dodaj obraz do akapitu
        var paragraph = section.Paragraphs.Add();
        paragraph.AddImage("path/to/image.jpg", new Rectangle(0, 0, 100, 100));

        document.SaveAs("example_with_image.docx");
    }
}

using IronWord;
using System.Drawing;

class Program
{
    static void Main()
    {
        var document = new WordDocument();
        var section = document.Sections.Add();

        // Dodaj obraz do akapitu
        var paragraph = section.Paragraphs.Add();
        paragraph.AddImage("path/to/image.jpg", new Rectangle(0, 0, 100, 100));

        document.SaveAs("example_with_image.docx");
    }
}

Imports IronWord
Imports System.Drawing

Class Program
    Shared Sub Main()
        Dim document = New WordDocument()
        Dim section = document.Sections.Add()

        ' Dodaj obraz do akapitu
        Dim paragraph = section.Paragraphs.Add()
        paragraph.AddImage("path/to/image.jpg", New Rectangle(0, 0, 100, 100))

        document.SaveAs("example_with_image.docx")
    End Sub
End Class

Dodawanie tabeli

Dodanie tabeli wymaga utworzenia tabeli, wierszy, kolumn i komórek. Umożliwia to szerokie możliwości konfiguracyjne, ponieważ każda komórka może mieć różne style. Przykład:

using IronWord;

class Program
{
    static void Main()
    {
        var document = new WordDocument();
        var section = document.Sections.Add();
        var table = section.Tables.Add(3, 3); // tabela 3x3

        // Iteruj po komórkach i ustaw ich zawartość
        for (int i = 0; i < table.Rows.Count; i++)
        {
            for (int j = 0; j < table.Rows[i].Cells.Count; j++)
            {
                table.Rows[i].Cells[j].Paragraphs.Add().AppendText($"Cell {i+1},{j+1}");
            }
        }

        document.SaveAs("example_with_table.docx");
    }
}

using IronWord;

class Program
{
    static void Main()
    {
        var document = new WordDocument();
        var section = document.Sections.Add();
        var table = section.Tables.Add(3, 3); // tabela 3x3

        // Iteruj po komórkach i ustaw ich zawartość
        for (int i = 0; i < table.Rows.Count; i++)
        {
            for (int j = 0; j < table.Rows[i].Cells.Count; j++)
            {
                table.Rows[i].Cells[j].Paragraphs.Add().AppendText($"Cell {i+1},{j+1}");
            }
        }

        document.SaveAs("example_with_table.docx");
    }
}

Imports IronWord

Module Program

    Sub Main()
        Dim document = New WordDocument()
        Dim section = document.Sections.Add()
        Dim table = section.Tables.Add(3, 3) ' tabela 3x3

        ' Iteruj po komórkach i ustaw ich zawartość
        For i As Integer = 0 To table.Rows.Count - 1
            For j As Integer = 0 To table.Rows(i).Cells.Count - 1
                table.Rows(i).Cells(j).Paragraphs.Add().AppendText($"Cell {i + 1},{j + 1}")
            Next
        Next

        document.SaveAs("example_with_table.docx")
    End Sub

End Module

Licencjonowanie i wsparcie

IronWord jest biblioteką płatną; dostępne są jednak bezpłatne licencje próbne tutaj.

Więcej informacji o Iron Software można znaleźć na stronie: https://ironsoftware.com/. W celu uzyskania wsparcia i odpowiedzi na pytania prosimy o kontakt z naszym zespołem.