Erste Schritte mit IronWord

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: Setzen von Textumbruch, Positionsversatz, Breite, Höhe, Formtyp und Drehung.

Installation

Install-Package IronWord

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"

Beispiele für Code

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

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 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

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

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

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.