Getting Started with IronWord

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

IronWord: Word-Dokument-Bibliothek für .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: Konfiguration von Papiergröße, Seitenorientierung, Rändern und Hintergrundfarbe.
  • TextRun: Bearbeitung von Textinhalten, Stilen, Teilen, Anhängen von Text und Hinzufügen von Bildern.
  • TextStyle: Verwaltung von Schriftfamilie, Größe, Farbe, Fett, Kursiv, Durchgestrichen, Unterstrichen, Hoch- und Tiefstellung.
  • Paragraph: Hinzufügen von Textläufen, Bildern, Formen, Einstellen von Stilen, Ausrichtungen, Aufzählungszeichen und Nummerierungslisten.
  • Table: Bearbeitung der Tabellenstruktur, einschließlich Hinzufügen von Zeilen, Abrufen und Festlegen von Zellenwerten, Entfernen von Zeilen, Zusammenführen von Zellen und mehr.
  • Image: Laden von Bildern aus Dateien oder Streams, Einstellung des Textumbruchs, Positionsversatz, Breite, Höhe und andere Eigenschaften.
  • Shape: Einstellung des Textumbruchs, Positionsversatz, Breite, Höhe, Formtyp und Drehung.
class="hsg-featured-snippet">

Word-Dokument-C#-Bibliothek für .NET

  1. Laden Sie die C#-Bibliothek zum Umgang mit DOCX-Dokumenten herunter
  2. Erstellen und Bearbeiten von Word- und DOCX-Dokumenten
  3. Hinzufügen von Dokumentstrukturen wie Absätzen, Abschnitten und Tabellen
  4. Hinzufügen von Dokumentelementen wie Textruns, Bildern und Formen
  5. Gestalten Sie die Dokumentelemente mühelos

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 beginnen, indem Sie using IronWord; an den Anfang Ihrer C#-Code-Datei hinzufügen.

Lizenzschlüssel anwenden

Als Nächstes wenden Sie einen gültigen Lizenz- oder Testschlüssel auf IronWord an, indem Sie den Lizenzschlüssel der LicenseKey-Eigenschaft der License-Klasse 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. Wählen Sie 'Datei' > 'Informationen' und klicken Sie auf "Konvertieren".
  2. Sie erhalten eine Meldung, dass Ihr Dokument in das neueste Dateiformat aktualisiert wird. Klicken Sie auf "OK".

Erstellen von Word- und Docx-Dokumenten

Erstellen Sie das Word-Dokument, indem Sie die WordDocument-Klasse mit einem ihrer Konstruktoren instanziieren. Anschließend verwenden Sie die SaveAs-Methode, 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 wie einem Paragraph, TableCell oder Section hinzugefügt werden. Verwenden Sie die AddImage-Methode, 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 25,807 | Version: 2025.11 gerade veröffentlicht