Rozpoczęcie Pracy z IronWord

Curtis Chau
Curtis Chau
Updated: 11 czerwca 2025

IronWord: Biblioteka Dokumentów Word dla .NET

IronWord to biblioteka dokumentów Word opracowana przez Iron Software. IronWord doskonali się w zapewnianiu solidnej funkcjonalności do pracy z dokumentami Word w aplikacjach .NET.

  • Ładowanie, manipulowanie i zapisywanie dokumentów Word i Docx.
  • PageSetup: Konfigurowanie rozmiaru papieru, orientacji strony, marginesów i koloru tła.
  • TextRun: Obsługa treści tekstu, stylów, dzielenie, dodawanie tekstu i dodawanie obrazów.
  • TextStyle: Zarządzanie czcionką, rozmiarem, kolorem, pogrubieniem, kursywą, przekreśleniem, podkreśleniem, indeksy górne i dolne.
  • Paragraph: Dodawanie fragmentów tekstu, obrazów, kształtów, ustawianie stylów, wyrównania, punktorów i list numerowanych.
  • Table: Manipulowanie strukturą tabeli, w tym dodawanie wierszy, pobieranie i ustawianie wartości komórek, usuwanie wierszy, scalanie komórek i nie tylko.
  • Image: Ładowanie 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, rodzaju kształtu i rotacji.

Instalacja

Biblioteka IronWord

Instalacja IronWord jest szybka i prosta. Możesz zainstalować pakiet używając NuGet z następującą komendą:

PM > Install-Package IronWord

Alternatywnie, pobierz bezpośrednio z oficjalnej strony NuGet IronWord.

Po zainstalowaniu możesz rozpocząć, dodając using IronWord; na początku pliku kodu C#.

Stosowanie klucza licencyjnego

Następnie zastosuj ważną licencję lub klucz próbny do IronWord, przypisując klucz licencyjny do właściwości LicenseKey klasy License. Dołącz następujący kod zaraz po instrukcji importu, zanim użyjesz jakichkolwiek metod IronWord:

using IronWord;

// Assign your license key
License.LicenseKey = "YOUR_LICENSE_KEY_HERE";

Przykłady kodu

Przeanalizujmy teraz kilka przykładów kodu i dostępnych funkcji.

Zwróć uwagę: Plik DOCX wytworzony przez IronWord, gdy otwarty w pewnej wersji Microsoft Word, może być w trybie zgodności, co powoduje niedostępność niektórych stylów. Aby przekonwertować dokument Word poza trybem zgodności
  1. Wybierz 'Plik' > 'Informacje' i kliknij "Konwertuj."
  2. Otrzymasz komunikat informujący, że twój dokument zostanie zaktualizowany do najnowszego formatu pliku. Kliknij "OK."

Tworzenie dokumentów Word i Docx

Utwórz dokument Word, instancjując klasę WordDocument za pomocą jednego z jej konstruktorów. Następnie użyj metody SaveAs, aby wyeksportować dokument Word. Przykład:

using IronWord;

class Program
{
    static void Main()
    {
        // Create a new Word document
        var document = new WordDocument();

        // Save the document as a .docx file
        document.SaveAs("example.docx");
    }
}

Dodaj obraz

Obrazu nie można dodać samodzielnie; zamiast tego powinno być dodane do jednej z struktur dokumentu, takich jak Paragraph, TableCell lub Section. Użyj metody AddImage, aby dodać obraz. Przykład:

using IronWord;
using IronWord.Models;

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

        // Add an image to a paragraph
        var paragraph = new Paragraph();
        section.AddParagraph(paragraph);
        paragraph.AddImage(new ImageContent("path/to/image.jpg") { Width = 100, Height = 100 });

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

Dodaj Tabelę

Dodanie tabeli wymaga utworzenia tabeli, wierszy, kolumn oraz komórek tabeli. To umożliwia znaczące możliwości konfiguracji, ponieważ każda komórka może mieć różne style. Przykład:

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        var document = new WordDocument();
        var section = new DocumentSection();
        document.AddSection(section);
        var table = new Table(3, 3); // 3x3 table
        section.AddTable(table);

        // Iterate over cells and set their content
        for (int i = 0; i < table.Rows.Count; i++)
        {
            for (int j = 0; j < table.Rows[i].Cells.Count; j++)
            {
                ((TableCell)table.Rows[i].Cells[j]).AddParagraph(new Paragraph(new TextContent($"Cell {i+1},{j+1}")));
            }
        }

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

Licencjonowanie i wsparcie dostępne

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

Aby uzyskać więcej informacji o Iron Software, odwiedź naszą stronę internetową: https://ironsoftware.com/. Aby uzyskać więcej wsparcia i zapytań, proszę skontaktować się z naszym zespołem.

Wsparcie od Iron Software

W przypadku ogólnego wsparcia i pytań technicznych, prosimy o kontakt mailowy na adres: support@ironsoftware.com

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

Gotowy, aby rozpocząć?

Nuget Downloads 61,140Wersja:2026.11właśnie wydany