Erste Schritte mit IronWord

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronWord: Word-Dokument-Bibliothek for .NET

IronWord ist eine Word-Dokument-Bibliothek entwickelt von Iron Software. IronWord bietet eine robuste Funktionalität zum Arbeiten mit Word-Dokumenten in .NET-Anwendungen.

  • Laden, Bearbeiten und Speichern von Word- und Docx-Dokumenten.
  • PageSetup: Konfigurieren von Papierformat, Seitenausrichtung, Rändern und Hintergrundfarbe.
  • TextRun: Bearbeitung von Textinhalten, Stilen, Aufteilen, Anhängen von Text und Hinzufügen von Bildern.
  • TextStyle: Verwaltung von Schriftart, Schriftgröße, Farbe, Fettdruck, Kursivschrift, Durchstreichen, Unterstreichen, Hoch- und Tiefstellung.
  • Paragraph: Hinzufügen von Textzeilen, Bildern, Formen, Formatierungen, Ausrichtungen, Aufzählungszeichen und nummerierten Listen.
  • Table: Bearbeiten der Tabellenstruktur, einschließlich Hinzufügen von Zeilen, Abrufen und Festlegen von Zellwerten, Entfernen von Zeilen, Zusammenführen von Zellen und mehr.
  • Image: Laden von Bildern aus Dateien oder Streams, Festlegen von Textumbruch, Positionsversatz, Breite, Höhe und anderen Eigenschaften.
  • Shape: Festlegen von Textumbruch, Positionsversatz, Breite, Höhe, Formtyp und Drehung.

Installation

IronWord-Bibliothek

Die Installation von IronWord ist schnell und einfach. Sie können das Paket mit NuGet mit folgendem Befehl installieren:

Install-Package IronWord

Alternativ können Sie es direkt von der offiziellen IronWord NuGet-Website herunterladen.

Nach der Installation können Sie loslegen, indem Sie using IronWord; am Anfang Ihrer C#-Code-Datei einfügen.

Lizenzschlüssel anwenden

Wenden Sie anschließend eine gültige Lizenz oder einen Testschlüssel auf IronWord an, indem Sie den Lizenzschlüssel der Eigenschaft LicenseKey der Klasse License zuweisen. Fügen Sie den folgenden Code direkt nach der Importerklärung hinzu, bevor Sie irgendwelche IronWord-Methoden verwenden:

using IronWord;

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

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

' Assign your license key
License.LicenseKey = "YOUR_LICENSE_KEY_HERE"
$vbLabelText   $csharpLabel

Beispiele für Code

Lassen Sie uns einige Codebeispiele und die verfügbaren Funktionen erkunden.

Hinweis:Die von IronWord erzeugte DOCX-Datei kann beim Öffnen in einer bestimmten Version von Microsoft Word im Kompatibilitätsmodus sein, was dazu führt, dass einige der Formatierungen nicht verfügbar sind. Um ein Word-Dokument aus dem Kompatibilitätsmodus zu konvertieren

  1. 'Datei' > 'Informationen' wählen und auf "Konvertieren" klicken.
  2. Sie erhalten eine Meldung, dass Ihr Dokument in das neueste Dateiformat aktualisiert wird. Auf "OK" klicken.

Erstellen von Word- und Docx-Dokumenten

Erstellen Sie das WORD-Dokument, indem Sie die Klasse WordDocument mithilfe eines ihrer Konstruktoren instanziieren. Verwenden Sie anschließend die Methode SaveAs, um das WORD-Dokument zu exportieren. Beispiel:

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");
    }
}
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");
    }
}
Imports IronWord

Friend Class Program
	Shared Sub Main()
		' Create a new Word document
		Dim document = New WordDocument()

		' Save the document as a .docx file
		document.SaveAs("example.docx")
	End Sub
End Class
$vbLabelText   $csharpLabel

Bild hinzufügen

Ein Bild kann nicht alleine hinzugefügt werden; Stattdessen sollte es zu einer der Dokumentstrukturen hinzugefügt werden, wie z. B. Paragraph, TableCell oder Section. Verwenden Sie die Methode AddImage, um ein Bild hinzuzufügen. Beispiel:

using IronWord;
using System.Drawing;

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

        // Add an image to a paragraph
        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();

        // Add an image to a paragraph
        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

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

		' Add an image to a paragraph
		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
$vbLabelText   $csharpLabel

Tabelle hinzufügen

Das Hinzufügen einer Tabelle erfordert das Erstellen von Tabelle, Zeilen, Spalten und Tabellenzellen. Dies bietet erhebliche Konfigurationsmöglichkeiten, da jede Zelle unterschiedliche Stile haben kann. Beispiel:

using IronWord;

class Program
{
    static void Main()
    {
        var document = new WordDocument();
        var section = document.Sections.Add();
        var table = section.Tables.Add(3, 3); // 3x3 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++)
            {
                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); // 3x3 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++)
            {
                table.Rows[i].Cells[j].Paragraphs.Add().AppendText($"Cell {i+1},{j+1}");
            }
        }

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

Friend Class Program
	Shared Sub Main()
		Dim document = New WordDocument()
		Dim section = document.Sections.Add()
		Dim table = section.Tables.Add(3, 3) ' 3x3 table

		' Iterate over cells and set their content
		For i As Integer = 0 To table.Rows.Count - 1
			Dim j As Integer = 0
			Do While j < table.Rows(i).Cells.Count
				table.Rows(i).Cells(j).Paragraphs.Add().AppendText($"Cell {i+1},{j+1}")
				j += 1
			Loop
		Next i

		document.SaveAs("example_with_table.docx")
	End Sub
End Class
$vbLabelText   $csharpLabel

Lizenzierung & Support verfügbar

IronWord ist eine kostenpflichtige Bibliothek; jedoch sind kostenlose Testlizenzen verfügbar hier.

Für weitere Informationen über Iron Software besuchen Sie bitte unsere Website: https://ironsoftware.com/. Für weitere Unterstützung und Anfragen können Sie unser Team fragen.

Unterstützung von Iron Software

Für allgemeinen Support und technische Anfragen senden Sie uns bitte eine E-Mail an: support@ironsoftware.com

Curtis Chau
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 44,829 | Version: 2026.5 just released
Still Scrolling Icon

Scrollst du immer noch?

Sie brauchen schnell einen Beweis? PM > Install-Package IronWord
Führen Sie ein Beispiel aus und sehen Sie zu, wie aus Ihren Daten ein Word-Dokument wird.