# 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`: Konfigurieren von Papierformat, Seitenorientierung, Rändern und Hintergrundfarbe.
- `TextRun`: Handhabung von Textinhalten, Stilen, Aufteilen, Anfügen von Text und Hinzufügen von Bildern.
- `TextStyle`: Verwaltung von Schriftartfamilie, Größe, Farbe, Fett, Kursiv, Durchgestrichen, Unterstreichen, Hoch- und Tiefstellung.
- `Paragraph`: Hinzufügen von Textläufen, Bildern, Formen, Einstellen von Stilen, Ausrichtungen, Aufzählungszeichen und Nummerierungen.
- `Table`: Manipulation der Tabellenstruktur, einschließlich Hinzufügen von Zeilen, Abrufen und Einrichten von Zellwerten, Entfernen von Zeilen, Zusammenführen von Zellen und mehr.
- `Image`: Laden von Bildern aus Dateien oder Streams, Einstellen von Textumbruch, Positionsversatz, Breite, Höhe und anderen Eigenschaften.
- `Shape`: Einstellen von Textumbruch, Positionsversatz, Breite, Höhe, Formtyp und Rotation.
<div class="hsg-featured-snippet">
<h2>Word-Dokument-C#-Bibliothek für .NET</h2>
<ol>
<li><a class="js-modal-open" data-modal-id="trial-license-after-download" href="https://www.nuget.org/packages/IronWord/">Laden Sie die C#-Bibliothek zum Verarbeiten von DOCX-Dokumenten herunter.</a></li>
<li>Word- und DOCX-Dokumente erstellen und bearbeiten</li>
<li>Fügen Sie Dokumentstrukturen wie Absätze, Abschnitte und Tabellen hinzu.</li>
<li>Fügen Sie Dokumentelemente wie Textabschnitte, Bilder und Formen hinzu.</li>
<li>Gestalten Sie die Dokumentelemente ganz einfach</li>
</ol>
</div>
## Installation
### IronWord-Bibliothek
Die Installation von IronWord ist schnell und einfach. Sie können das Paket mit NuGet mit folgendem Befehl installieren:
```shell
:ProductInstall
```
Alternativ können Sie es direkt von der [offiziellen IronWord NuGet-Website](https://www.nuget.org/packages/IronWord) herunterladen.
Sobald installiert, können Sie loslegen, indem Sie `using IronWord;` am Anfang Ihrer C#-Datei hinzufügen.
## Lizenzschlüssel anwenden
Als nächstes wenden Sie einen gültigen Lizenzschlüssel oder Testlizenz an 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:
```csharp
using 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.
[[i:(Die von IronWord erzeugte DOCX-Datei kann beim Öffnen in einer bestimmten Version von Microsoft Word im **Kompatibilitätsmodus** sein, was dazu führt, dass einige der Formatierungen nicht verfügbar sind. Um ein Word-Dokument aus dem Kompatibilitätsmodus zu konvertieren)]]
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. Danach verwenden Sie die `SaveAs`-Methode, um das Word-Dokument zu exportieren. Beispiel:
```csharp
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");
}
}
```
## Bild hinzufügen
Ein Bild kann nicht alleine hinzugefügt werden; Stattdessen sollte es zu einer der Dokumentstrukturen hinzugefügt werden, wie ein `Paragraph`, `TableCell` oder `Section`. Verwenden Sie die `AddImage`-Methode, um ein Bild hinzuzufügen. Beispiel:
```csharp
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");
}
}
```
## 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:
```csharp
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");
}
}
```
## Lizenzierung & Support verfügbar
**IronWord** ist eine kostenpflichtige Bibliothek; jedoch sind kostenlose Testlizenzen verfügbar [hier](trial-license).
Für weitere Informationen über Iron Software besuchen Sie bitte unsere Website: [https://ironsoftware.com/](https://ironsoftware.com/). Für weitere Unterstützung und Anfragen können Sie [unser Team fragen](https://www.ironsoftware.com/csharp/word/docs/#live-chat-support).
### Unterstützung von Iron Software
Für allgemeinen Support und technische Anfragen senden Sie uns bitte eine E-Mail an: [support@ironsoftware.com](mailto:support@ironsoftware.com)
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: Konfigurieren von Papierformat, Seitenorientierung, Rändern und Hintergrundfarbe.
TextRun: Handhabung von Textinhalten, Stilen, Aufteilen, Anfügen von Text und Hinzufügen von Bildern.
TextStyle: Verwaltung von Schriftartfamilie, Größe, Farbe, Fett, Kursiv, Durchgestrichen, Unterstreichen, Hoch- und Tiefstellung.
Paragraph: Hinzufügen von Textläufen, Bildern, Formen, Einstellen von Stilen, Ausrichtungen, Aufzählungszeichen und Nummerierungen.
Table: Manipulation der Tabellenstruktur, einschließlich Hinzufügen von Zeilen, Abrufen und Einrichten von Zellwerten, Entfernen von Zeilen, Zusammenführen von Zellen und mehr.
Image: Laden von Bildern aus Dateien oder Streams, Einstellen von Textumbruch, Positionsversatz, Breite, Höhe und anderen Eigenschaften.
Shape: Einstellen von Textumbruch, Positionsversatz, Breite, Höhe, Formtyp und Rotation.
Sobald installiert, können Sie loslegen, indem Sie using IronWord; am Anfang Ihrer C#-Datei hinzufügen.
Lizenzschlüssel anwenden
Als nächstes wenden Sie einen gültigen Lizenzschlüssel oder Testlizenz an 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 keyLicense.LicenseKey = "YOUR_LICENSE_KEY_HERE";
using IronWord;
// Assign your license key
License.LicenseKey = "YOUR_LICENSE_KEY_HERE";
ImportsIronWord' Assign your license keyLicense.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.
Hinweis:: Die von IronWord erzeugte DOCX-Datei kann beim Öffnen in einer bestimmten Version von Microsoft Word im Kompatibilitätsmodus sein, was dazu führt, dass einige der Formatierungen nicht verfügbar sind. Um ein Word-Dokument aus dem Kompatibilitätsmodus zu konvertieren
'Datei' > 'Informationen' wählen und auf "Konvertieren" klicken.
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. Danach verwenden Sie die SaveAs-Methode, um das Word-Dokument zu exportieren. Beispiel:
using IronWord;class Program{ static voidMain() { // 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");
}
}
ImportsIronWordFriend Class ProgramShared Sub Main() ' Create a new Word document Dim document = New WordDocument() ' Save the document as a .docx file document.SaveAs("example.docx") End SubEnd Class
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 hinzugefügt werden, wie ein Paragraph, TableCell oder Section. Verwenden Sie die AddImage-Methode, um ein Bild hinzuzufügen. Beispiel:
using IronWord;using System.Drawing;class Program{ static voidMain() { 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");
}
}
ImportsIronWordImportsSystem.DrawingFriend Class ProgramShared 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 SubEnd Class
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 voidMain() { 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");
}
}
ImportsIronWordFriend Class ProgramShared 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 AsInteger = 0 To table.Rows.Count - 1 Dim j AsInteger = 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 SubEnd Class
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.
Unterstützung von Iron Software
Für allgemeinen Support und technische Anfragen senden Sie uns bitte eine E-Mail an: support@ironsoftware.com
Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.