.NET Word API (Wie es für Entwickler funktioniert)

Einführung

Die .NET Word API bietet Entwicklern robuste Tools zur Konvertierung von Word-Dokumenten, zur Interaktion mit und zur Bearbeitung von MS Word-Dokumenten in ihren Anwendungen. Diese API wurde entwickelt, um die Arbeit mit Microsoft Word-Dokumenten zu rationalisieren und das Erstellen, Bearbeiten, Konvertieren und Verwalten von Dokumenten programmatisch zu erleichtern. In diesem Artikel werden wir folgende Themen behandeln IronWord um seine Fähigkeiten bei der Bearbeitung von Word-Dokumenten zu verstehen.

Einführung in IronWord

IronWord ist eine .NET-Word-Bibliothek innerhalb des .NET-Word-API-Ökosystems, die speziell für Entwickler entwickelt wurde, die Microsoft Word-Dokumente in ihren .NET-Anwendungen verarbeiten. Mit IronWord können Entwickler Word-Dokumente problemlos lesen, schreiben und ändern, ohne dass Microsoft Word auf dem Server oder den Client-Rechnern installiert sein muss. Diese Fähigkeit ist besonders vorteilhaft für Anwendungen, die Aufgaben der Dokumentenverarbeitung automatisieren müssen, wie z. B. die Erstellung von Berichten, Rechnungen oder personalisierter Korrespondenz durch Serienbrieffunktionen.

Merkmale von IronWord

IronWord bietet eine umfassende Palette von Funktionen, die verschiedene Aspekte der Bearbeitung von Word-Dokumenten abdecken. Schauen wir uns die einzelnen Funktionen an, wobei wir uns darauf konzentrieren, wie sie die Bearbeitung und Zusammenführung mehrerer Dokumente ermöglichen, die unter den Kategorien "Dokumentstruktur" und "Dokumentelemente" zusammengefasst sind.

Struktur des Dokuments

Word lesen und bearbeiten: Mit IronWord können Sie bestimmte Informationen aus Ihren Word-Dokumenten extrahieren, z. B. Text zur Bearbeitung oder Wiederverwendung, und Bilder abrufen, die an anderer Stelle verwendet werden sollen. Diese Fähigkeit ist für Anwendungen, die Word-Dokumente zusammenführen und die in vorhandenen DOCX-Dateien enthaltenen Informationen verarbeiten sollen, unerlässlich.

Mehrere Formate: IronWord for .NET unterstützt eine Vielzahl von Dateiformaten, was den Nutzen bei der Konvertierung von Word-Dokumenten in .NET-Anwendungen erhöht.

Seiteneinrichtung bearbeiten: Mit IronWord können Sie das physische Layout Ihrer Word-Dokumente ganz einfach anpassen. Sie können das Papierformat für verschiedene MS Word-Dateien an Standard- oder benutzerdefinierte Abmessungen anpassen, die Ausrichtung für verschiedene Abschnitte Ihres Dokuments ändern, die Ränder einstellen, um eine korrekte Ausrichtung zu gewährleisten, und sogar die Hintergrundfarbe für ästhetische Zwecke oder zur Hervorhebung von Abschnitten ändern.

Absätze hinzufügen: IronWord ermöglicht das Hinzufügen und Entfernen von Text läuft in Absätzendie für die Bearbeitung und Formatierung großer Textabschnitte unerlässlich ist. Darüber hinaus können Sie Ihre Absätze aufwerten, indem Sie Bilder und Formen direkt in den Text einfügen, das Styling an Ihre Designvorgaben anpassen und Ausrichtungen für ein ausgefeiltes Aussehen festlegen. Die Möglichkeit, Aufzählungszeichen und Nummerierungslisten hinzuzufügen, hilft ebenfalls dabei, Inhalte effektiver zu organisieren.

using IronWord;
using IronWord.Models;
// Load docx
WordDocument doc = new WordDocument();
// Create and add styled text to a paragraph
Paragraph paragraph = new Paragraph();
paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));
paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));
paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));
// Add paragraph and export docx
doc.AddParagraph(paragraph);
doc.SaveAs("newdocument.docx");

using IronWord;
using IronWord.Models;
// Load docx
WordDocument doc = new WordDocument();
// Create and add styled text to a paragraph
Paragraph paragraph = new Paragraph();
paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));
paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));
paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));
// Add paragraph and export docx
doc.AddParagraph(paragraph);
doc.SaveAs("newdocument.docx");

Imports IronWord
Imports IronWord.Models
' Load docx
Private doc As New WordDocument()
' Create and add styled text to a paragraph
Private paragraph As New Paragraph()
paragraph.AddTextRun(New TextRun("Exploring text styles within a document."))
paragraph.AddTextRun(New TextRun("An example in italic.", New TextStyle With {.IsItalic = True}))
paragraph.AddTextRun(New TextRun("An example in bold.", New TextStyle With {.IsBold = True}))
' Add paragraph and export docx
doc.AddParagraph(paragraph)
doc.SaveAs("newdocument.docx")

Tabellen hinzufügen: Tabellen sind ein wichtiger Bestandteil von DOCX-Dateien und können mit IronWord leicht bearbeitet werden, wodurch die dynamische Dokumentenerstellung unterstützt wird. Sie können Zeilen und Spalten hinzufügen oder entfernen, ein Vorgang, der für die dynamische Dokumentenerstellung wichtig ist, bei der die Datenmenge variieren kann. Das Zusammenführen und Teilen von Zellen gibt Ihnen die Möglichkeit, komplexe Tabellen zu formatieren, und das Anpassen von Rahmen und Layoutabmessungen sorgt für ein ausgefeiltes, professionelles Aussehen.

using IronWord;
using IronWord.Models;
// Create a table cell with a paragraph containing text
TableCell cell = new TableCell(new Paragraph(new TextRun("Sample text")));
// Configure a common border style for the table
BorderStyle borderStyle = new BorderStyle
{
    BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
    BorderValue = IronWord.Models.Enums.BorderValues.Thick,
    BorderSize = 5
};
// Apply the border style to the cell
cell.Borders = new TableBorders
{
    TopBorder = borderStyle,
    RightBorder = borderStyle,
    BottomBorder = borderStyle,
    LeftBorder = borderStyle
};
// Create a table row and add the same cell twice
TableRow row = new TableRow();
row.AddCell(cell);
row.AddCell(cell);
// Create a table, add the row, then create and export the Word document
Table table = new Table();
table.AddRow(row);
WordDocument doc = new WordDocument(table);
doc.SaveAs("Document.docx");

using IronWord;
using IronWord.Models;
// Create a table cell with a paragraph containing text
TableCell cell = new TableCell(new Paragraph(new TextRun("Sample text")));
// Configure a common border style for the table
BorderStyle borderStyle = new BorderStyle
{
    BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
    BorderValue = IronWord.Models.Enums.BorderValues.Thick,
    BorderSize = 5
};
// Apply the border style to the cell
cell.Borders = new TableBorders
{
    TopBorder = borderStyle,
    RightBorder = borderStyle,
    BottomBorder = borderStyle,
    LeftBorder = borderStyle
};
// Create a table row and add the same cell twice
TableRow row = new TableRow();
row.AddCell(cell);
row.AddCell(cell);
// Create a table, add the row, then create and export the Word document
Table table = new Table();
table.AddRow(row);
WordDocument doc = new WordDocument(table);
doc.SaveAs("Document.docx");

Imports IronWord
Imports IronWord.Models
' Create a table cell with a paragraph containing text
Private cell As New TableCell(New Paragraph(New TextRun("Sample text")))
' Configure a common border style for the table
Private borderStyle As New BorderStyle With {
	.BorderColor = New IronColor(IronSoftware.Drawing.Color.Black),
	.BorderValue = IronWord.Models.Enums.BorderValues.Thick,
	.BorderSize = 5
}
' Apply the border style to the cell
cell.Borders = New TableBorders With {
	.TopBorder = borderStyle,
	.RightBorder = borderStyle,
	.BottomBorder = borderStyle,
	.LeftBorder = borderStyle
}
' Create a table row and add the same cell twice
Dim row As New TableRow()
row.AddCell(cell)
row.AddCell(cell)
' Create a table, add the row, then create and export the Word document
Dim table As New Table()
table.AddRow(row)
Dim doc As New WordDocument(table)
doc.SaveAs("Document.docx")

Elemente des Dokuments

Hinzufügen von TextRuns: Bei dieser Funktion geht es um eine feinere Kontrolle des Textinhalts. Sie können Textläufe hinzufügen, anhängen und aufteilen, was für die dynamische Erstellung von Dokumenten unerlässlich ist. Die Gestaltungsmöglichkeiten sind umfangreich und umfassen das Ändern von Schriftfamilien, -größen und -farben sowie das Hinzufügen von Fett-, Kursiv- und anderen Textdekorationen. Sie können auch Bilder in Textläufe einbetten und so ein reichhaltiges, visuell ansprechendes Dokument erstellen.

Bilder hinzufügen: IronWord ermöglicht eine umfassende *Bildmanipulation in Word-Dokumenten. Sie können Bilder aus verschiedenen Quellen laden, sie nahtlos mit Text umrahmen und ihre Abmessungen an Ihr Layout anpassen. Durch die Möglichkeit, den Positionsversatz und den Abstand zu den Ecken des Dokuments einzustellen, werden Ihre Bilder immer perfekt platziert.

using IronWord;
using IronWord.Models;
WordDocument doc = new WordDocument();
IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
{
    Width = 200, // In unit pixel
    Height = 200 // In unit pixel
};
Create paragraph, add image, add paragraph to doc, and export
Paragraph paragraph = new Paragraph();
paragraph.AddImage(image);
doc.AddParagraph(paragraph);
doc.SaveAs("save_document.docx");

using IronWord;
using IronWord.Models;
WordDocument doc = new WordDocument();
IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
{
    Width = 200, // In unit pixel
    Height = 200 // In unit pixel
};
Create paragraph, add image, add paragraph to doc, and export
Paragraph paragraph = new Paragraph();
paragraph.AddImage(image);
doc.AddParagraph(paragraph);
doc.SaveAs("save_document.docx");

Imports IronWord
Imports IronWord.Models
Private doc As New WordDocument()
Private image As New IronWord.Models.Image("your-image.jpg") With {
	.Width = 200,
	.Height = 200
}
Private paragraph, add, add, [and] As Create
paragraph.AddImage(image)
doc.AddParagraph(paragraph)
doc.SaveAs("save_document.docx")

Formen hinzufügen: Formen können ein Dokument optisch deutlich aufwerten, und IronWord gibt Ihnen die Werkzeuge an die Hand, mit denen Sie sie präzise einfügen und anpassen können. Sie können den Formtyp einstellen (wie Rechtecke, Kreise, Pfeile, usw.)bestimmen Sie, wie der Text um die Form herumlaufen soll, legen Sie die genauen Abmessungen und die Positionierung fest und drehen Sie die Form, um den gewünschten visuellen Effekt zu erzielen.

Kompatibilität

.NET-Versionen und Projekttypen

IronWord wurde für eine breite Kompatibilität innerhalb des .NET-Ökosystems entwickelt und unterstützt C#, VB.NET und F# in verschiedenen .NET-Versionen, einschließlich .NET Core, .NET Standard und .NET-Framework. Dies gewährleistet seine Nützlichkeit sowohl in modernen als auch in älteren Anwendungen. Die Vielseitigkeit der Bibliothek erstreckt sich auf alle Projekttypen und ermöglicht die Integration von Web-, Mobil- und Desktop-Anwendungen mit Blazor, WebForms, Xamarin, MAUI, WPF und Konsolenanwendungen.

App-Umgebungen

Was die Anwendungsumgebungen betrifft, so ist IronWord an Windows-, Linux-, iOS- und Android-Plattformen anpassbar, einschließlich spezifischer Unterstützung für Containerisierung und Cloud-Bereitstellung auf Docker, Azure und AWS. Diese weitreichende Unterstützung erleichtert die Entwicklung in verschiedenen Umgebungen.

OS & IDE

IronWord ist auch mit den wichtigsten integrierten Entwicklungsumgebungen kompatibel (IDEs) wie Microsoft Visual Studio, ReSharper und Rider, was den Entwicklern Flexibilität bei der Auswahl der Tools bietet. Und schließlich unterstützt es verschiedene Betriebssysteme und Prozessorarchitekturen (x64, x86, ARM)und gewährleisten eine effiziente Leistung bei unterschiedlichen Hardwarekonfigurationen.

Optionen für die Lizenzierung

IronWord bietet verschiedene Lizenzierungsoptionen an, um den Anforderungen unterschiedlicher Entwickler und Organisationen gerecht zu werden. Sie bieten eine unbefristete Lizenz an, d. h. Sie zahlen einmal und es fallen keine laufenden Gebühren an. Jede Lizenz beinhaltet ein Jahr Produktsupport und Updates. Die Lizenzstufen richten sich nach der Anzahl der Entwickler, Standorte und Projekte, die Sie haben. Sie können auch eine kostenlos testen um praktische Erfahrungen zu sammeln, bevor Sie eine Lizenz erwerben.

Lite-Lizenz

Diese Option ist für einzelne Entwickler gedacht, die allein an einem Projekt arbeiten. Der Preis beträgt $749 und deckt einen Entwickler an einem einzigen Standort ab.

Plus-Lizenz

Diese Lizenz für 1.499 US-Dollar richtet sich an kleine Teams und kann von bis zu drei Entwicklern an drei Standorten für drei Projekte genutzt werden.

Berufliche Lizenz

Für größere Teams ist die Professional-Lizenz zum Preis von 2.999 US-Dollar erhältlich und unterstützt bis zu zehn Entwickler. Es ist für umfangreichere Operationen konzipiert und umfasst erstklassige Supportfunktionen.

Schlussfolgerung

Zum Abschluss, IronWord entpuppt sich als robuste und flexible .NET Word-API, die eine Reihe von Lizenzierungsoptionen bietet, um den unterschiedlichen Anforderungen einzelner Entwickler und Teams gerecht zu werden. Seine Funktionen ermöglichen eine effiziente Verwaltung und Bearbeitung von Word-Dokumenten und gewährleisten die Kompatibilität mit verschiedenen .NET-Versionen und Projekttypen.