Ein Vergleich zwischen IronWord & Microsoft.Office.Interop.Word

3.1 Hauptmerkmale

Eigenständige Dokumentenverarbeitung:

IronWord ermöglicht die Bearbeitung von Word-Dokumenten direkt in .NET-Anwendungen, ohne dass Microsoft Office Word installiert sein muss. Diese Unabhängigkeit vereinfacht die Bereitstellung und reduziert die Komplexität von Entwicklungsumgebungen, insbesondere in Server- oder Cloud-Kontexten.

Dokumentenkonvertierung:

Eine wichtige Funktion von IronWord ist die Möglichkeit, Word-Dokumente in andere Formate wie PDF, HTML und Klartext zu konvertieren. Diese Funktion ist unerlässlich für Anwendungen, die Dokumente in verschiedenen Formaten darstellen müssen, oder für Webanwendungen, die die Anzeige von Dokumentinhalten in HTML erfordern.

Umfassende Formatierungsoptionen:

IronWord bietet eine breite Palette an Formatierungsmöglichkeiten, mit denen Entwickler Textstile anwenden , Absatzausrichtungen hinzufügen und Elemente wie Tabellen und Bilder einfügen können. Diese Optionen gewährleisten, dass von IronWord erstellte oder geänderte Dokumente den erforderlichen visuellen und strukturellen Standards entsprechen.

Einfache Integration in .NET-Projekte:

IronWord wurde speziell für .NET-Anwendungen entwickelt und lässt sich über NuGet problemlos in jedes .NET-Projekt integrieren. Die API ist so konzipiert, dass sie für .NET-Entwickler intuitiv zu bedienen ist und den Einstieg in die Arbeit mit Word-Dokumenten erleichtert.

Plattformübergreifende Kompatibilität:

IronWord unterstützt die plattformübergreifende Entwicklung und eignet sich daher für den Einsatz in Anwendungen, die auf verschiedene Betriebssysteme abzielen. Dies ist besonders wertvoll für Projekte, die sowohl unter dem Windows-Betriebssystem als auch unter dem Linux-Betriebssystem oder in Cloud-Umgebungen laufen müssen.

4.1 In Visual Studio öffnen

Starten Sie zunächst Microsoft Visual Studio. Nach dem Öffnen der Anwendung wird Ihnen das Startfenster angezeigt. Dieses Fenster bietet verschiedene Möglichkeiten für den Einstieg, darunter das Öffnen eines bestehenden Projekts oder das Erstellen eines neuen. Für unsere Zwecke konzentrieren Sie sich auf die Initiierung eines neuen Projekts.

Ein Vergleich zwischen IronWord und Microsoft.Office.Interop.Word: Abbildung 3 – Erstellen eines neuen Projekts in Visual Studio

4.2 Auswahl des Projekttyps

Nach dem Klicken auf die Option zum Erstellen eines neuen Projekts zeigt Visual Studio Ihnen eine Liste von Vorlagen an. Wählen Sie als Nächstes das Projekt "Konsolen-App" aus.

Ein Vergleich zwischen IronWord und Microsoft.Office.Interop.Word: Abbildung 4 – Erstellen eines Konsolenanwendungsprojekts

4.3 Konfiguration des Projekts

Sobald Sie die gewünschte Projektvorlage ausgewählt haben, gelangen Sie durch Klicken auf "Weiter" zum Projektkonfigurationsbildschirm. Hier müssen Sie wesentliche Details zu Ihrem Projekt angeben. Dies beinhaltet die Angabe des Projektnamens und die Auswahl des Speicherorts für Ihre Projektdateien, z. B. einen Programmordner, der für die interne Verwendung durch Anwendungen reserviert ist.

Ein Vergleich zwischen IronWord und Microsoft.Office.Interop.Word: Abbildung 5 – Konfigurieren des Projektnamens und des Dateipfads

Im nächsten Dialogfeld muss das Zielframework ausgewählt werden. Das von Ihnen gewählte .NET Framework bestimmt die für Ihre Anwendung verfügbaren Bibliotheken und APIs und beeinflusst somit deren Kompatibilität und Funktionalität. Achten Sie darauf, eine Framework-Version auszuwählen, die die Funktionen unterstützt, die Sie in Ihrer Anwendung implementieren möchten, und nutzen Sie die Visual Studio-Tools für ein optimiertes Entwicklungserlebnis.

Ein Vergleich zwischen IronWord und Microsoft.Office.Interop.Word: Abbildung 6 – Auswahl des geeigneten .NET-Frameworks

4.4 Erstellung des Projekts

Nachdem Sie die erforderlichen Informationen ausgefüllt und sichergestellt haben, dass alle Einstellungen korrekt auf die Anforderungen Ihres Projekts abgestimmt sind, besteht der letzte Schritt darin, das Projekt zu erstellen. Dies wird durch Klicken auf die Schaltfläche "Erstellen" erreicht. Visual Studio initialisiert anschließend ein neues Projekt basierend auf der ausgewählten Vorlage und den Konfigurationen. Dieser Vorgang kann einige Augenblicke dauern. Anschließend ist Ihr neues .NET-Projekt geöffnet und bereit für die Entwicklung.

5.1 Verwendung des NuGet-Paketmanagers

Der NuGet-Paketmanager ist eine benutzerfreundliche Oberfläche innerhalb von Visual Studio, die die nahtlose Installation von Bibliotheken und Tools ermöglicht. Um die IronWord-Bibliothek mit dieser Methode zu installieren, befolgen Sie diese Schritte:

1. Öffnen Sie den NuGet-Paket-Manager : Klicken Sie bei geöffnetem Projekt im Projektmappen-Explorer mit der rechten Maustaste auf den Projektnamen und wählen Sie im Kontextmenü "NuGet-Pakete verwalten…" aus. Diese Aktion öffnet das Fenster des NuGet-Paket-Managers.

2. Suchen Sie nach IronWord : Navigieren Sie im NuGet-Paketmanager-Fenster zur Registerkarte "Durchsuchen". Verwenden Sie das Suchfeld, um die IronWord-Bibliothek zu finden, indem Sie "IronWord" eingeben und die Eingabetaste drücken.

   Ein Vergleich zwischen IronWord und Microsoft.Office.Interop.Word: Abbildung 7 – Installation von IronWord mithilfe des NuGet-Paketmanagers

3. Installieren Sie IronWord : Wählen Sie in den Suchergebnissen das IronWord-Paket aus. Sie sehen dort eine detaillierte Beschreibung und Versionsinformationen. Wählen Sie die Version, die Ihren Projektanforderungen entspricht, und klicken Sie auf die Schaltfläche "Installieren". Visual Studio kümmert sich anschließend um das Herunterladen und Installieren der Bibliothek und aktualisiert Ihre Projektverweise entsprechend.

5.2 Verwenden der Visual Studio Befehlszeile

Für diejenigen, die lieber mit Befehlszeilentools arbeiten, bietet Visual Studio die Package Manager Console an, eine PowerShell-Schnittstelle zur Verwaltung von NuGet-Paketen.

1. Zugriff auf die Paket-Manager-Konsole : Navigieren Sie im Hauptmenü von Visual Studio zu "Tools" > "NuGet Package Manager" > "Paket-Manager-Konsole".

2. Installieren Sie IronWord : Geben Sie in der Konsole den folgenden Befehl ein und drücken Sie die Eingabetaste:

   Install-Package IronWord

   Dieser Befehl lädt die neueste Version der IronWord-Bibliothek herunter und integriert sie in Ihr Projekt. Sie können eine bestimmte Version angeben, indem Sie den Parameter -Version gefolgt von der Versionsnummer hinzufügen.

Ein Vergleich zwischen IronWord und Microsoft.Office.Interop.Word: Abbildung 8 – Installation von IronWord über die VS-Befehlszeile

5.3 Direkter Download von der NuGet-Webseite

Ein Vergleich zwischen IronWord und Microsoft.Office.Interop.Word: Abbildung 9 – Installation von IronWord über die NuGet-Webseite

Wenn Sie die Bibliotheken Ihres Projekts lieber manuell verwalten möchten, können Sie das IronWord-Paket direkt von der NuGet-Website herunterladen und Ihrem Projekt hinzufügen.

1. Laden Sie das Paket herunter : Besuchen Sie nuget.org und suchen Sie nach dem IronWord-Paket. Auf der Paketseite finden Sie den Link " Download ", über den Sie die .nupkg- Datei erhalten. Speichern Sie diese Datei auf Ihrem Computer.
2. Zum Projekt hinzufügen : Nach dem Herunterladen können Sie das Paket manuell zu Ihrem Projekt hinzufügen. Dieser Prozess beinhaltet typischerweise das Extrahieren der .nupkg- Datei und das anschließende Hinzufügen von Verweisen auf die enthaltenen Assemblies in Ihrem Projekt. Allerdings ist es im Allgemeinen einfacher und weniger fehleranfällig, den NuGet-Paketmanager oder die Visual Studio-Befehlszeile wie oben beschrieben zu verwenden.

6.1 Verwendung des NuGet-Paketmanagers

Ein Vergleich zwischen IronWord und Microsoft.Office.Interop.Word: Abbildung 10 – Installation von Microsoft.Office.Interop.Word über den NuGet-Paketmanager

Der NuGet-Paketmanager in Visual Studio ist die einfachste Methode, die Microsoft.Office.Interop.Word-Bibliothek zu Ihrem Projekt hinzuzufügen. Folgen Sie diesen Schritten:

1. NuGet-Paket-Manager öffnen : Wenn Ihr Projekt in Visual Studio geöffnet ist, klicken Sie mit der rechten Maustaste auf den Projektnamen im Projektmappen-Explorer. Wählen Sie im Kontextmenü "NuGet-Pakete verwalten…", um das Fenster des NuGet-Paket-Managers zu öffnen.
2. Bibliothek suchen : Wechseln Sie im Fenster des NuGet-Paket-Managers zur Registerkarte "Durchsuchen" und geben Sie "Microsoft.Office.Interop.Word" in das Suchfeld ein. Drücken Sie die Eingabetaste, um die Suche zu starten.
3. Installieren Sie das Paket : Suchen Sie in den Suchergebnissen nach dem Paket "Microsoft.Office.Interop.Word". Prüfen Sie die bereitgestellten Versionsinformationen und die Beschreibung, um sicherzustellen, dass sie den Anforderungen Ihres Projekts entsprechen. Klicken Sie auf die Schaltfläche "Installieren", um die Bibliothek zu Ihrem Projekt hinzuzufügen. Visual Studio übernimmt das Herunterladen und Installieren des Pakets und aktualisiert Ihre Projektverweise, um die erforderliche Assembly einzuschließen.

6.2 Verwenden der Visual Studio-Befehlszeile

Ein Vergleich zwischen IronWord und Microsoft.Office.Interop.Word: Abbildung 11 – Installation von Microsoft.Office.Interop.Word über die VS-Befehlszeile

Die Package Manager Console, eine Befehlszeilenschnittstelle innerhalb von Visual Studio, bietet eine weitere Möglichkeit zur Installation der Microsoft.Office.Interop.Word-Bibliothek.

1. Zugriff auf die Paket-Manager-Konsole : Gehen Sie im Hauptmenü von Visual Studio zu "Tools" > "NuGet Package Manager" > "Paket-Manager-Konsole".

2. Installationsbefehl ausführen : Geben Sie in der Konsole den folgenden Befehl ein und drücken Sie die Eingabetaste:

   Install-Package Microsoft.Office.Interop.Word

Dieser Befehl weist Visual Studio an, die neueste Version der Bibliothek abzurufen und in Ihr Projekt zu integrieren. Falls Sie eine bestimmte Version der Bibliothek benötigen, können Sie diese angeben, indem Sie den Parameter -Version gefolgt von der gewünschten Versionsnummer anhängen.

6.3 Direkter Download von der NuGet-Webseite

Ein Vergleich zwischen IronWord und Microsoft.Office.Interop.Word: Abbildung 12 – Installation von Microsoft.Office.Interop.Word von der NuGet-Webseite

Für Entwickler, die die manuelle Verwaltung von Projektabhängigkeiten bevorzugen, kann die Microsoft.Office.Interop.Word-Bibliothek direkt von der NuGet-Website heruntergeladen werden.

1. Laden Sie das Paket herunter : Navigieren Sie zu nuget.org und suchen Sie nach "Microsoft.Office.Interop.Word". Auf der Paketseite finden Sie den Link " Download ", über den Sie die .nupkg- Datei erhalten. Speichern Sie diese Datei an einem Ort Ihrer Wahl auf Ihrem Computer.
2. Paket manuell zum Projekt hinzufügen : Nach dem Herunterladen kann die .nupkg- Datei manuell zum Projekt hinzugefügt werden. Dies beinhaltet typischerweise das Extrahieren der Datei und das Hinzufügen von Verweisen auf die extrahierten Assemblies in Ihrem Projekt. Dennoch wird zur Vereinfachung der Bedienung und zur Minimierung potenzieller Fehler die Verwendung des NuGet-Paketmanagers oder der Visual Studio-Befehlszeile empfohlen.

7.1 Erweiterte Funktionen von IronWord

using IronWord;
using IronWord.Models;

// Initialize a new Word document
WordDocument document = new WordDocument("my_new_document.docx");

// Insert new text content into the document
document.AddText("This is a demonstration of modifying content with IronWord.");

// Save the document with a new filename
document.SaveAs("updated_document.docx");

using IronWord;
using IronWord.Models;

// Initialize a new Word document
WordDocument document = new WordDocument("my_new_document.docx");

// Insert new text content into the document
document.AddText("This is a demonstration of modifying content with IronWord.");

// Save the document with a new filename
document.SaveAs("updated_document.docx");

Imports IronWord
Imports IronWord.Models

' Initialize a new Word document
Private document As New WordDocument("my_new_document.docx")

' Insert new text content into the document
document.AddText("This is a demonstration of modifying content with IronWord.")

' Save the document with a new filename
document.SaveAs("updated_document.docx")

using IronWord;
using IronWord.Models;

// Initialize a new Word document
WordDocument document = new WordDocument();

// Insert text into the document
document.AddText("Exploring IronWord Capabilities");

// Save the document to a new file
document.SaveAs("updated_ironword_document.docx");

using IronWord;
using IronWord.Models;

// Initialize a new Word document
WordDocument document = new WordDocument();

// Insert text into the document
document.AddText("Exploring IronWord Capabilities");

// Save the document to a new file
document.SaveAs("updated_ironword_document.docx");

Imports IronWord
Imports IronWord.Models

' Initialize a new Word document
Private document As New WordDocument()

' Insert text into the document
document.AddText("Exploring IronWord Capabilities")

' Save the document to a new file
document.SaveAs("updated_ironword_document.docx")

using IronWord;
using IronWord.Models;

// Initialize a new Word document
WordDocument document = new WordDocument();

// Setup an image
IronWord.Models.Image img = new IronWord.Models.Image("updated_image.jpg");
img.Width = 250; // Width in pixels
img.Height = 250; // Height in pixels

// Create a paragraph to contain the image
Paragraph para = new Paragraph();
// Incorporate an image into the paragraph
para.AddImage(img);

// Add the paragraph to the document
document.AddParagraph(para);

// Save the document with a new name
document.SaveAs("updated_save_document.docx");

using IronWord;
using IronWord.Models;

// Initialize a new Word document
WordDocument document = new WordDocument();

// Setup an image
IronWord.Models.Image img = new IronWord.Models.Image("updated_image.jpg");
img.Width = 250; // Width in pixels
img.Height = 250; // Height in pixels

// Create a paragraph to contain the image
Paragraph para = new Paragraph();
// Incorporate an image into the paragraph
para.AddImage(img);

// Add the paragraph to the document
document.AddParagraph(para);

// Save the document with a new name
document.SaveAs("updated_save_document.docx");

Imports IronWord
Imports IronWord.Models

' Initialize a new Word document
Private document As New WordDocument()

' Setup an image
Private img As New IronWord.Models.Image("updated_image.jpg")
img.Width = 250 ' Width in pixels
img.Height = 250 ' Height in pixels

' Create a paragraph to contain the image
Dim para As New Paragraph()
' Incorporate an image into the paragraph
para.AddImage(img)

' Add the paragraph to the document
document.AddParagraph(para)

' Save the document with a new name
document.SaveAs("updated_save_document.docx")

using IronSoftware.Drawing;
using IronWord;
using IronWord.Models;
using Color = IronSoftware.Drawing.Color;

// Initialize WordDocument with a file
WordDocument document = new WordDocument("updated_document.docx");

// Create a TextRun with modifications
TextRun modifiedTextRun = new TextRun
{
    Text = "Updated text with IronWord",
    Style = new TextStyle
    {
        FontFamily = "Arial",
        FontSize = 48, // Adjusted font size
        TextColor = new IronColor(Color.Blue),
        IsBold = false,
        IsItalic = false,
        IsUnderline = false,
        IsSuperscript = true,
        IsStrikethrough = false,
        IsSubscript = true
    }
};

// Create a paragraph and add the TextRun
Paragraph newParagraph = new Paragraph();
newParagraph.AddTextRun(modifiedTextRun);

// Add the paragraph to the document
document.AddParagraph(newParagraph);

// Save the document with a new name
document.SaveAs("updated_save_document.docx");

using IronSoftware.Drawing;
using IronWord;
using IronWord.Models;
using Color = IronSoftware.Drawing.Color;

// Initialize WordDocument with a file
WordDocument document = new WordDocument("updated_document.docx");

// Create a TextRun with modifications
TextRun modifiedTextRun = new TextRun
{
    Text = "Updated text with IronWord",
    Style = new TextStyle
    {
        FontFamily = "Arial",
        FontSize = 48, // Adjusted font size
        TextColor = new IronColor(Color.Blue),
        IsBold = false,
        IsItalic = false,
        IsUnderline = false,
        IsSuperscript = true,
        IsStrikethrough = false,
        IsSubscript = true
    }
};

// Create a paragraph and add the TextRun
Paragraph newParagraph = new Paragraph();
newParagraph.AddTextRun(modifiedTextRun);

// Add the paragraph to the document
document.AddParagraph(newParagraph);

// Save the document with a new name
document.SaveAs("updated_save_document.docx");

Imports IronSoftware.Drawing
Imports IronWord
Imports IronWord.Models
Imports Color = IronSoftware.Drawing.Color

' Initialize WordDocument with a file
Private document As New WordDocument("updated_document.docx")

' Create a TextRun with modifications
Private modifiedTextRun As New TextRun With {
	.Text = "Updated text with IronWord",
	.Style = New TextStyle With {
		.FontFamily = "Arial",
		.FontSize = 48,
		.TextColor = New IronColor(Color.Blue),
		.IsBold = False,
		.IsItalic = False,
		.IsUnderline = False,
		.IsSuperscript = True,
		.IsStrikethrough = False,
		.IsSubscript = True
	}
}

' Create a paragraph and add the TextRun
Private newParagraph As New Paragraph()
newParagraph.AddTextRun(modifiedTextRun)

' Add the paragraph to the document
document.AddParagraph(newParagraph)

' Save the document with a new name
document.SaveAs("updated_save_document.docx")

using IronWord;
using IronWord.Models;

// Create a table cell
TableCell cell = new TableCell();
TextRun textRun = new TextRun();
textRun.Text = "Updated content"; // Changed the text content

// Add a TextRun to the cell
cell.AddContent(new Paragraph(textRun));

// Configure border style
BorderStyle borderStyle = new BorderStyle
{
    BorderColor = new IronColor(IronSoftware.Drawing.Color.Blue), // Changed border color to blue
    BorderValue = IronWord.Models.Enums.BorderValues.Double, // Changed border style to double
    BorderSize = 3 // Adjusted border size to 3
};

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

// Assign borders to the cell
cell.Borders = tableBorders;

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

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

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

// Export the Word document
doc.SaveAs("UpdatedDocument.docx");

using IronWord;
using IronWord.Models;

// Create a table cell
TableCell cell = new TableCell();
TextRun textRun = new TextRun();
textRun.Text = "Updated content"; // Changed the text content

// Add a TextRun to the cell
cell.AddContent(new Paragraph(textRun));

// Configure border style
BorderStyle borderStyle = new BorderStyle
{
    BorderColor = new IronColor(IronSoftware.Drawing.Color.Blue), // Changed border color to blue
    BorderValue = IronWord.Models.Enums.BorderValues.Double, // Changed border style to double
    BorderSize = 3 // Adjusted border size to 3
};

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

// Assign borders to the cell
cell.Borders = tableBorders;

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

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

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

// Export the Word document
doc.SaveAs("UpdatedDocument.docx");

Imports IronWord
Imports IronWord.Models

' Create a table cell
Private cell As New TableCell()
Private textRun As New TextRun()
textRun.Text = "Updated content" ' Changed the text content

' Add a TextRun to the cell
cell.AddContent(New Paragraph(textRun))

' Configure border style
Dim borderStyle As New BorderStyle With {
	.BorderColor = New IronColor(IronSoftware.Drawing.Color.Blue),
	.BorderValue = IronWord.Models.Enums.BorderValues.Double,
	.BorderSize = 3
}

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

' Assign borders to the cell
cell.Borders = tableBorders

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

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

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

' Export the Word document
doc.SaveAs("UpdatedDocument.docx")

7.2 Spezielle erweiterte Funktionen von Microsoft.Office.Interop.Word

using Microsoft.Office.Interop.Word;

// Create a new Word application and document
var application = new Application();
var document = application.Documents.Add();

// Add a combo box content control
object missing = System.Reflection.Missing.Value;
var cc = document.ContentControls.Add(WdContentControlType.wdContentControlComboBox, ref missing);
cc.Title = "Choose an option";
cc.DropdownListEntries.Add("Option 1", "1");
cc.DropdownListEntries.Add("Option 2", "2");

using Microsoft.Office.Interop.Word;

// Create a new Word application and document
var application = new Application();
var document = application.Documents.Add();

// Add a combo box content control
object missing = System.Reflection.Missing.Value;
var cc = document.ContentControls.Add(WdContentControlType.wdContentControlComboBox, ref missing);
cc.Title = "Choose an option";
cc.DropdownListEntries.Add("Option 1", "1");
cc.DropdownListEntries.Add("Option 2", "2");

Imports Microsoft.Office.Interop.Word

' Create a new Word application and document
Private application = New Application()
Private document = application.Documents.Add()

' Add a combo box content control
Private missing As Object = System.Reflection.Missing.Value
Private cc = document.ContentControls.Add(WdContentControlType.wdContentControlComboBox, missing)
cc.Title = "Choose an option"
cc.DropdownListEntries.Add("Option 1", "1")
cc.DropdownListEntries.Add("Option 2", "2")

using Microsoft.Office.Interop.Word;

// Create a new document for mail merge
var mailMergeDoc = application.Documents.Add();

// Open the data source for the mail merge
mailMergeDoc.MailMerge.OpenDataSource("path\\to\\datasource.xlsx");

// Execute the mail merge
mailMergeDoc.MailMerge.Destination = WdMailMergeDestination.wdSendToNewDocument;
mailMergeDoc.MailMerge.Execute(false);

using Microsoft.Office.Interop.Word;

// Create a new document for mail merge
var mailMergeDoc = application.Documents.Add();

// Open the data source for the mail merge
mailMergeDoc.MailMerge.OpenDataSource("path\\to\\datasource.xlsx");

// Execute the mail merge
mailMergeDoc.MailMerge.Destination = WdMailMergeDestination.wdSendToNewDocument;
mailMergeDoc.MailMerge.Execute(false);

Imports Microsoft.Office.Interop.Word

' Create a new document for mail merge
Private mailMergeDoc = application.Documents.Add()

' Open the data source for the mail merge
mailMergeDoc.MailMerge.OpenDataSource("path\to\datasource.xlsx")

' Execute the mail merge
mailMergeDoc.MailMerge.Destination = WdMailMergeDestination.wdSendToNewDocument
mailMergeDoc.MailMerge.Execute(False)

using Microsoft.Office.Interop.Word;

// Enable track changes
document.TrackRevisions = true;

// Add a comment to the first paragraph
object start = 0;
object end = 0;
Range range = document.Paragraphs[1].Range;
document.Comments.Add(range, "This is a comment.");

using Microsoft.Office.Interop.Word;

// Enable track changes
document.TrackRevisions = true;

// Add a comment to the first paragraph
object start = 0;
object end = 0;
Range range = document.Paragraphs[1].Range;
document.Comments.Add(range, "This is a comment.");

Imports Microsoft.Office.Interop.Word

' Enable track changes
document.TrackRevisions = True

' Add a comment to the first paragraph
Dim start As Object = 0
Dim [end] As Object = 0
Dim range As Range = document.Paragraphs(1).Range
document.Comments.Add(range, "This is a comment.")

using Microsoft.Office.Interop.Word;

// Iterate through sections in the document and set headers and footers
foreach (Section section in document.Sections)
{
    // Set text for primary header
    section.Headers[WdHeaderFooterIndex.wdHeaderFooterPrimary].Range.Text = "Header Text";

    // Add page numbers to primary footer
    section.Footers[WdHeaderFooterIndex.wdHeaderFooterPrimary].PageNumbers.Add();
}

using Microsoft.Office.Interop.Word;

// Iterate through sections in the document and set headers and footers
foreach (Section section in document.Sections)
{
    // Set text for primary header
    section.Headers[WdHeaderFooterIndex.wdHeaderFooterPrimary].Range.Text = "Header Text";

    // Add page numbers to primary footer
    section.Footers[WdHeaderFooterIndex.wdHeaderFooterPrimary].PageNumbers.Add();
}

Imports Microsoft.Office.Interop.Word

' Iterate through sections in the document and set headers and footers
For Each section As Section In document.Sections
	' Set text for primary header
	section.Headers(WdHeaderFooterIndex.wdHeaderFooterPrimary).Range.Text = "Header Text"

	' Add page numbers to primary footer
	section.Footers(WdHeaderFooterIndex.wdHeaderFooterPrimary).PageNumbers.Add()
Next section

using Microsoft.Office.Interop.Word;

// Add a table of contents to the document
var toc = document.TablesOfContents.Add(document.Content, UpperHeadingLevel: 1, LowerHeadingLevel: 3, UseHyperlinks: true);

// Add an index to the document
var index = document.Indexes.Add(document.Content);

using Microsoft.Office.Interop.Word;

// Add a table of contents to the document
var toc = document.TablesOfContents.Add(document.Content, UpperHeadingLevel: 1, LowerHeadingLevel: 3, UseHyperlinks: true);

// Add an index to the document
var index = document.Indexes.Add(document.Content);

Imports Microsoft.Office.Interop.Word

' Add a table of contents to the document
Private toc = document.TablesOfContents.Add(document.Content, UpperHeadingLevel:= 1, LowerHeadingLevel:= 3, UseHyperlinks:= True)

' Add an index to the document
Private index = document.Indexes.Add(document.Content)

using Microsoft.Office.Interop.Word;

// Embed an Excel sheet into the document
object missing = System.Reflection.Missing.Value;
document.InlineShapes.AddOLEObject(
    ClassType: "Excel.Sheet", 
    FileName: "path\\to\\excel.xlsx", 
    LinkToFile: false, 
    DisplayAsIcon: false, 
    IconFileName: ref missing, 
    IconIndex: ref missing, 
    IconLabel: ref missing, 
    Anchor: ref missing
);

using Microsoft.Office.Interop.Word;

// Embed an Excel sheet into the document
object missing = System.Reflection.Missing.Value;
document.InlineShapes.AddOLEObject(
    ClassType: "Excel.Sheet", 
    FileName: "path\\to\\excel.xlsx", 
    LinkToFile: false, 
    DisplayAsIcon: false, 
    IconFileName: ref missing, 
    IconIndex: ref missing, 
    IconLabel: ref missing, 
    Anchor: ref missing
);

Imports Microsoft.Office.Interop.Word

' Embed an Excel sheet into the document
Private missing As Object = System.Reflection.Missing.Value
document.InlineShapes.AddOLEObject(ClassType:= "Excel.Sheet", FileName:= "path\to\excel.xlsx", LinkToFile:= False, DisplayAsIcon:= False, IconFileName:= missing, IconIndex:= missing, IconLabel:= missing, Anchor:= missing)

8.1 IronWord-Dokumentation und Support

IronWord bietet eine umfassende Dokumentation und Unterstützung, um Entwicklern zu helfen, sein volles Potenzial auszuschöpfen. Die Dokumentation umfasst eine breite Palette an Ressourcen, darunter eine detaillierte Kurzanleitung, Funktionsübersichten, Schnellstartbeispiele und umfassende API-Referenzen.

Der Support für IronWord ist umfassend und bietet technische Unterstützung, um sicherzustellen, dass Entwickler etwaige Probleme schnell beheben können. Das Support-System umfasst ein eigenes Team, das für die Beantwortung von Fragen und die Behebung von Problemen zur Verfügung steht.

8.2 Microsoft.Office.Interop.Word Dokumentation und Support

Microsoft.Office.Interop.Word bietet .NET-Entwicklern die Werkzeuge zur programmatischen Interaktion mit Word-Dokumenten, unterstützt durch die umfangreiche Dokumentation und den Support von Microsoft. Die Dokumentation umfasst alles von Anfängerleitfäden bis hin zu fortgeschrittenen Beispielen, detaillierten API-Informationen und praktischen Anwendungsfällen.

Für Support bietet Microsoft verschiedene Kanäle an, darunter direkte technische Unterstützung, Community-Foren und Plattformen wie Stack Overflow für Peer-Support. GitHub ist auch für die Meldung von Problemen und das Vorschlagen von Verbesserungen unerlässlich. Regelmäßige Aktualisierungen gewährleisten, dass die Bibliothek mit den neuen Word-Versionen Schritt hält und spiegeln das kontinuierliche Engagement von Microsoft für die Bedürfnisse der Entwickler wider.

9.1 IronWord-Lizenz

Ein Vergleich zwischen IronWord und Microsoft.Office.Interop.Word: Abbildung 20 – IronWord-Lizenzseite

IronWord bietet sowohl kostenlose als auch kommerzielle Lizenzoptionen an.

• Lite-Lizenz : $liteLicense USD
  • Für 1 Entwickler
  • 1 Standort
  • 1 Projekt
  • E-Mail-Support
• Plus-Lizenz : $plusLicense USD
  • Bis zu 3 Entwickler
  • 3 Standorte
  • 3 Projekte
  • E-Mail- (24/7) und Chat-Support
  • Telefonischer Support
• Berufslizenz : $professionalLicense USD
  • Bis zu 10 Entwickler
  • 10 Standorte
  • 10 Projekte
  • E-Mail- (24/7), Chat- und Telefonsupport
  • Unterstützung für Bildschirmfreigabe

Alle kommerziellen Lizenzen beinhalten prioritären Support und Updates. Zudem bietet es eine kostenlose Testversion , mit der Sie alle Funktionen in einer Produktionsumgebung ohne Wasserzeichen ausprobieren können.

9.2 Microsoft.Office.Interop.Word-Lizenz

Die Lizenzierung für Microsoft.Office.Interop.Word ist an die Microsoft Office Suite gebunden. Für die Interop-Bibliothek selbst ist keine separate Lizenz erforderlich; Es ist in Microsoft Office enthalten. Die Verwendung von Microsoft.Office.Interop.Word in Anwendungen erfordert, dass die Bereitstellungsumgebung über eine gültige Microsoft Office-Lizenz verfügt, die Word umfasst.

Die Kosten hängen von der gewählten Office-Suite-Version und dem Lizenzvertrag ab und reichen von Einzellizenzen bis hin zu Volumenlizenzen für Unternehmen. Genaue Preisinformationen finden Sie auf der offiziellen Website von Microsoft oder erhalten Sie von einem Microsoft-Vertriebsmitarbeiter.