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

Dokumentenstruktur

Lesen & Bearbeiten von Word: Mit IronWord können Sie spezifische Informationen aus Ihren Word-Dokumenten extrahieren, wie zum Beispiel das Herausziehen von Text zur Bearbeitung oder Weiterverwendung und das Abrufen von Bildern, die möglicherweise an anderer Stelle verwendet werden müssen. Diese Fähigkeit ist entscheidend für Anwendungen, die darauf abzielen, Word-Dokumente zusammenzuführen und die in vorhandenen DOCX-Dateien enthaltenen Informationen zu verarbeiten.

Mehrere Formate: IronWord unterstützt eine Vielzahl von Dateiformaten, was seine Nützlichkeit bei der Konvertierung von Word-Dokumenten innerhalb von .NET-Anwendungen erhöht.

Seiteneinrichtung bearbeiten: Die physische Gestaltung Ihrer Word-Dokumente ist mit IronWord einfach. Sie können die Papiergröße für verschiedene MS Word-Dateien auf Standard- oder benutzerdefinierte Abmessungen anpassen, die Ausrichtung für verschiedene Abschnitte Ihres Dokuments ändern, die Ränder einstellen, um eine korrekte Ausrichtung sicherzustellen, und sogar die Hintergrundfarbe für ästhetische Zwecke oder um Abschnitte hervorzuheben, ändern.

Absätze hinzufügen: IronWord ermöglicht das Hinzufügen und Entfernen von Textläufen innerhalb von Absätzen, was für das Bearbeiten und Formatieren großer Textabschnitte wesentlich ist. Darüber hinaus können Sie Ihre Absätze verbessern, indem Sie Bilder und Formen direkt in den Text einfügen, das Styling an Ihre Designvorgaben anpassen und Ausrichtungen für ein hochwertiges Aussehen festlegen. Die Möglichkeit, Aufzählungszeichen und Nummerierungslisten hinzuzufügen, hilft auch, Inhalte effektiver zu organisieren.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Load docx
        WordDocument doc = new WordDocument();
        // Create and add styled text to a paragraph
        Paragraph paragraph = new Paragraph();

        // Adding regular text
        paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));

        // Adding italic text
        paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));

        // Adding bold text
        paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));

        // Add paragraph to the document and export docx
        doc.AddParagraph(paragraph);
        doc.SaveAs("newdocument.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Load docx
        WordDocument doc = new WordDocument();
        // Create and add styled text to a paragraph
        Paragraph paragraph = new Paragraph();

        // Adding regular text
        paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));

        // Adding italic text
        paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));

        // Adding bold text
        paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));

        // Add paragraph to the document and export docx
        doc.AddParagraph(paragraph);
        doc.SaveAs("newdocument.docx");
    }
}

Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Load docx
		Dim doc As New WordDocument()
		' Create and add styled text to a paragraph
		Dim paragraph As New Paragraph()

		' Adding regular text
		paragraph.AddTextRun(New TextRun("Exploring text styles within a document."))

		' Adding italic text
		paragraph.AddTextRun(New TextRun("An example in italic.", New TextStyle With {.IsItalic = True}))

		' Adding bold text
		paragraph.AddTextRun(New TextRun("An example in bold.", New TextStyle With {.IsBold = True}))

		' Add paragraph to the document and export docx
		doc.AddParagraph(paragraph)
		doc.SaveAs("newdocument.docx")
	End Sub
End Class

Tabellen hinzufügen: Tabellen sind ein kritischer Bestandteil von DOCX-Dateien und können mit IronWord einfach manipuliert werden, was die dynamische Dokumentenerstellung unterstützt. Sie können Zeilen und Spalten hinzufügen oder entfernen, eine Operation, die bei dynamischer Dokumentenerstellung, bei der die Datenmenge variieren kann, entscheidend ist. Das Zusammenführen und Teilen von Zellen gibt Ihnen die Vielseitigkeit, komplexe Tabellen zu formatieren, und das Anpassen der Umrandungen und Layout-Abmessungen ermöglicht einen polierten, professionellen Look.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // 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;

class Program
{
    static void Main()
    {
        // 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

Friend Class Program
	Shared Sub Main()
		' Create a table cell with a paragraph containing text
		Dim cell As New TableCell(New Paragraph(New TextRun("Sample text")))

		' Configure a common border style for the table
		Dim 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")
	End Sub
End Class

Dokumentenelemente

TextRuns hinzufügen: Diese Funktion konzentriert sich auf die feingliedrige Kontrolle über den Textinhalt. Sie können Textruns hinzufügen, anhängen und teilen, was für die dynamische Dokumentenerstellung von entscheidender Bedeutung ist. Die Styling-Optionen sind umfangreich, einschließlich der Änderung von Schriftarten, Größen und Farben sowie des Hinzufügens von Fettschrift, Kursivschrift und anderen Textverzierungen. Sie können auch Bilder in Textruns einbetten und so ein reichhaltiges, visuell ansprechendes Dokument erstellen.

Bilder hinzufügen: IronWord ermöglicht eine umfassende Bildbearbeitung innerhalb von Word-Dokumenten. Sie können Bilder aus verschiedenen Quellen laden, Text nahtlos um sie herumfließen lassen und ihre Dimensionen anpassen, um Ihr Layout zu ergänzen. Die Fähigkeit, den Positionsversatz und den Abstand von den Ecken des Dokuments festzulegen, stellt sicher, dass Ihre Bilder immer perfekt platziert sind.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        WordDocument doc = new WordDocument();

        // Load and configure the image
        IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
        {
            Width = 200, // In unit pixels
            Height = 200 // In unit pixels
        };

        // Create paragraph, add image, add paragraph to document, and export
        Paragraph paragraph = new Paragraph();
        paragraph.AddImage(image);

        // Add paragraph containing the image to the document
        doc.AddParagraph(paragraph);
        doc.SaveAs("save_document.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        WordDocument doc = new WordDocument();

        // Load and configure the image
        IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
        {
            Width = 200, // In unit pixels
            Height = 200 // In unit pixels
        };

        // Create paragraph, add image, add paragraph to document, and export
        Paragraph paragraph = new Paragraph();
        paragraph.AddImage(image);

        // Add paragraph containing the image to the document
        doc.AddParagraph(paragraph);
        doc.SaveAs("save_document.docx");
    }
}

Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		Dim doc As New WordDocument()

		' Load and configure the image
		Dim image As New IronWord.Models.Image("your-image.jpg") With {
			.Width = 200,
			.Height = 200
		}

		' Create paragraph, add image, add paragraph to document, and export
		Dim paragraph As New Paragraph()
		paragraph.AddImage(image)

		' Add paragraph containing the image to the document
		doc.AddParagraph(paragraph)
		doc.SaveAs("save_document.docx")
	End Sub
End Class

Formen hinzufügen: Formen können einem Dokument erheblichen visuellen Eindruck verleihen, und IronWord bietet Ihnen die Werkzeuge, um sie präzise einzufügen und anzupassen. Sie können den Formtyp (wie Rechtecke, Kreise, Pfeile usw.) festlegen, bestimmen, wie Text um die Form fließen soll, genaue Abmessungen und Positionierungen spezifizieren und sogar Formen drehen, um den gewünschten visuellen Effekt zu erzielen.

.NET-Versionen & Projekttypen

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

App-Umgebungen

In Bezug auf Anwendungsumgebungen ist IronWord anpassungsfähig an Windows-, Linux-, iOS- und Android-Plattformen, einschließlich spezifischer Unterstützung für Containerisierung und Cloud-Bereitstellung auf Docker, Azure und AWS. Diese umfassende Unterstützung erleichtert die Entwicklung über verschiedene Umgebungen hinweg.

Betriebssysteme & IDE

IronWord ist auch mit wichtigen integrierten Entwicklungsumgebungen (IDEs) wie Microsoft Visual Studio, ReSharper und Rider kompatibel, was Entwicklern Flexibilität bei der Wahl ihrer Werkzeuge bietet. Schließlich unterstützt es verschiedene Betriebssysteme und Prozessorarchitekturen (x64, x86, ARM), was eine effiziente Leistung auf verschiedenen Hardwarekonfigurationen gewährleistet.

Lite License

Diese Option ist für einzelne Entwickler maßgeschneidert, die alleine an einem Projekt arbeiten. Sie kostet $799 und deckt einen Entwickler an einem einzigen Standort ab.

Plus License

Diese Lizenz richtet sich an kleine Teams und kostet $plusLicense, ermöglicht die Arbeit von bis zu drei Entwicklern und ist anwendbar für drei Standorte über drei Projekte hinweg.

Professional License

Für größere Teams ist die Professional License zum Preis von $professionalLicense und unterstützt bis zu zehn Entwickler. Es ist für größere Operationen konzipiert und beinhaltet Premium-Support-Funktionen.