1. IronWord
  2. Los geht's

Erste Schritte mit IronWord

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

IronWord: Word-Dokumentenbibliothek für .NET

IronWord ist eine Word-Dokumentenbibliothek, die von Iron Software entwickelt wurde. IronWord for .NET zeichnet sich durch eine robuste Funktionalität für die Arbeit mit Word-Dokumenten in .NET-Anwendungen aus.

  • Word- und Docx-Dokumente laden, bearbeiten und speichern.
  • SeiteEinstellen: Einstellen von Papierformat, Seitenausrichtung, Rändern und Hintergrundfarbe.
  • TextRun: Handhabung von Textinhalten, Stilen, Aufteilung, Anhängen von Text und Hinzufügen von Bildern.
  • TextStyle: Verwaltung von Schriftfamilie, -größe, -farbe, fett, kursiv, durchgestrichen, unterstrichen, hochgestellt und tiefgestellt.
  • Absatz: Hinzufügen von Textläufen, Bildern, Formen, Einstellen von Stilen, Ausrichtungen, Aufzählungszeichen und Nummerierungslisten.
  • Tabelle: Manipulation der Tabellenstruktur, einschließlich Hinzufügen von Zeilen, Abrufen und Festlegen von Zellwerten, Entfernen von Zeilen, Zusammenführen von Zellen und mehr.
  • Bild: Laden von Bildern aus Dateien oder Streams, Einstellen von Umbruchtext, Positionsversatz, Breite, Höhe und anderen Eigenschaften.
  • Form: Einstellung von Umbruchtext, Positionsversatz, Breite, Höhe, Formtyp und Drehung.

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

    1. Laden Sie die C#-Bibliothek für den Umgang mit DOCX-Dokumenten herunter
    2. Word- und DOCX-Dokumente erstellen und ändern
    3. Hinzufügen von Dokumentstrukturen wie Absätzen, Abschnitten und Tabellen
    4. Hinzufügen von Dokumentelementen wie Textläufen, Bildern und Formen
    5. Einfaches Gestalten der Dokumentelemente

Einrichtung

IronWord Bibliothek

Die Installation von IronWord ist schnell und einfach, bitte installieren Sie das Paket wie folgt:

Install-Package IronWord

Alternativ können Sie die Datei auch direkt von deroffizielle IronWord NuGet-Website.

Nach der Installation können Sie loslegen, indem Sie using IronWord; am Anfang Ihres C#-Codes hinzufügen.

Lizenzschlüssel anwenden

Als nächstes wenden Sie 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 Import-Anweisung ein, bevor Sie irgendwelche IronWord-Methoden verwenden:

:path=/static-assets/word/content-code-examples/get-started/get-started-license.cs
IronWord.License.LicenseKey = "IRONWORD.MYLICENSE.KEY.1EF01";
IronWord.License.LicenseKey = "IRONWORD.MYLICENSE.KEY.1EF01"
VB   C#

Code-Beispiele

Wenn die von IronWord erzeugte DOCX-Datei in einer bestimmten Version von Microsoft Word geöffnet wird, befindet sie sich möglicherweise im Kompatibilitätsmodus, wodurch einige Formatierungen nicht verfügbar sind. So konvertieren Sie ein Word-Dokument aus dem Kompatibilitätsmodus:

  1. Wählen Sie "Datei" > "Info" und klicken Sie auf "Konvertieren"
  2. Es wird eine Meldung angezeigt, dass Ihr Dokument auf das neueste Dateiformat aktualisiert wird. Klicken Sie auf "OK"

Word- und Docx-Dokument erstellen

Erstellen Sie das Word-Dokument, indem Sie die Klasse WordDocument mit einem ihrer Konstruktoren instanziieren. Anschließend exportieren Sie das Word-Dokument mit der Methode SaveAs.

:path=/static-assets/word/content-code-examples/get-started/get-started-1.cs
using IronWord;
using IronWord.Models;

// Create textrun
Text textRun = new Text("Sample text");

Paragraph paragraph = new Paragraph();
paragraph.AddText(textRun);

// Create a new Word document
WordDocument doc = new WordDocument(paragraph);

// Export docx
doc.SaveAs("document.docx");
Imports IronWord
Imports IronWord.Models

' Create textrun
Private textRun As New Text("Sample text")

Private paragraph As New Paragraph()
paragraph.AddText(textRun)

' Create a new Word document
Dim doc As New WordDocument(paragraph)

' Export docx
doc.SaveAs("document.docx")
VB   C#

Bild hinzufügen

Ein Bild kann nicht allein hinzugefügt werden; stattdessen sollte er einer der Dokumentstrukturen hinzugefügt werden, z. B. einem "Absatz", einer "Tabellenzelle" oder einem "Abschnitt". Verwenden Sie die Methode AddImage, um ein Bild hinzuzufügen.

:path=/static-assets/word/content-code-examples/get-started/get-started-2.cs
using IronWord;
using IronWord.Models;

// Load docx
WordDocument doc = new WordDocument("document.docx");

// Configure image
IronWord.Models.Image image = new IronWord.Models.Image("image.jpg");
image.Width = 250; // In unit pixel
image.Height = 200; // In unit pixel
Paragraph paragraph = new Paragraph();

// Add image
paragraph.AddImage(image);

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("save_document.docx");
Imports IronWord
Imports IronWord.Models

' Load docx
Private doc As New WordDocument("document.docx")

' Configure image
Private image As New IronWord.Models.Image("image.jpg")
image.Width = 250 ' In unit pixel
image.Height = 200 ' In unit pixel
Dim paragraph As New Paragraph()

' Add image
paragraph.AddImage(image)

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("save_document.docx")
VB   C#

Tabelle hinzufügen

Das Hinzufügen einer Tabelle erfordert ein wenig mehr Arbeit, da die Tabelle, die Zeilen, die Spalten und die Tabellenzellen erstellt werden müssen. Allerdings gibt es bei diesem Aufbau erhebliche Konfigurationsmöglichkeiten. Jede Zelle kann einen anderen Stil haben. Entdecken Sie die verschiedenen Bordürenstile, die eine große Auswahl von 24 Typen bieten.

:path=/static-assets/word/content-code-examples/get-started/get-started-3.cs
using IronWord;
using IronWord.Models;

// Create table cell
TableCell cell = new TableCell();

Text textRun = new Text();
textRun.Text = "Sample text";

// Add textrun to the cell
cell.AddChild(new Paragraph(textRun));

// Configure border style
BorderStyle borderStyle = new BorderStyle();
borderStyle.BorderColor = Color.Black;
borderStyle.BorderValue = IronWord.Models.Enums.BorderValues.Thick;
borderStyle.BorderSize = 5;

// Configure table border
TableBorders tableBorders = new TableBorders() {
    TopBorder = borderStyle,
    RightBorder = borderStyle,
    BottomBorder = borderStyle,
    LeftBorder = borderStyle,
};

cell.Borders = tableBorders;

// Create row and add cell
TableRow row = new TableRow();
row.AddCell(cell);
row.AddCell(cell);

// Create table and add row
Table table = new Table();
table.AddRow(row);

// Create new Word document from the table
WordDocument doc = new WordDocument(table);

// Export Word document
doc.SaveAs("Document.docx");
Imports IronWord
Imports IronWord.Models

' Create table cell
Private cell As New TableCell()

Private textRun As New Text()
textRun.Text = "Sample text"

' Add textrun to the cell
cell.AddChild(New Paragraph(textRun))

' Configure border style
Dim borderStyle As New BorderStyle()
borderStyle.BorderColor = Color.Black
borderStyle.BorderValue = IronWord.Models.Enums.BorderValues.Thick
borderStyle.BorderSize = 5

' Configure table border
Dim tableBorders As New TableBorders() With {
	.TopBorder = borderStyle,
	.RightBorder = borderStyle,
	.BottomBorder = borderStyle,
	.LeftBorder = borderStyle
}

cell.Borders = tableBorders

' Create row and add cell
Dim row As New TableRow()
row.AddCell(cell)
row.AddCell(cell)

' Create table and add row
Dim table As New Table()
table.AddRow(row)

' Create new Word document from the table
Dim doc As New WordDocument(table)

' Export Word document
doc.SaveAs("Document.docx")
VB   C#

Lizenzierung & Support verfügbar

IronWord ist eine kostenpflichtige Bibliothek, es sind jedoch auch kostenlose Testlizenzen erhältlichhier.

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

Unterstützung durch Iron Software

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