C#-Tutorial zu Dokumentelementen

Curtis Chau
Curtis Chau
Aktualisiert: 2. August 2026

IronWord ist eine leistungsstarke Word-Dokumentenbibliothek, die .NET C#-Entwickler dabei unterstützt, die Funktionen zum Erstellen, Lesen und Bearbeiten von Word- und DOCX-Dokumenten in ihre Anwendungen zu integrieren. Im Kontext eines Word-Dokuments sind Dokumentelemente die Bausteine, die den Inhalt ausmachen.

Schnellstart: Erstellen eines formatierten Textlaufs und Einbetten eines Bildes

So können Sie IronWord verwenden, um reichhaltige Inhalte hinzuzufügen - durch Kombination von formatiertem Text und einem eingebetteten Bild in einem Dokument. Dieses Beispiel demonstriert das Run Wrapper-Muster für formatierten Text.

  1. 1Installieren Sie IronWord mit NuGet Package Manager

    PM > Install-Package IronWord

  2. 2Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    using IronWord;
    using IronWord.Models;
    
    // Create document
    WordDocument doc = new WordDocument();
    
    // Create styled Run
    Run textRun = new Run(new TextContent("Hello IronWord!"));
    textRun.Style = new TextStyle() { IsBold = true, Color = Color.Blue };
    
    // Create paragraph and add Run
    Paragraph paragraph = new Paragraph();
    paragraph.AddChild(textRun);
    paragraph.AddImage(new ImageContent("pic.png"));
    
    // Add to document and save
    doc.AddParagraph(paragraph);
    doc.SaveAs("output.docx");
  3. 3Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute, IronWord in Ihrem Projekt mit einer kostenlosen Testversion zu verwenden
    arrow pointer

Inhaltsverzeichnis

Schlüsselkonzepte

Dokumentenhierarchie

IronWord folgt einer strukturierten Dokumentenhierarchie: Document → Paragraph → Run → TextContent. Das Verständnis dieser Hierarchie ist für die Arbeit mit formatiertem Text unerlässlich:

  • WordDocument: Der oberste Container, der das gesamte Dokument darstellt
  • Paragraph: Ein Inhaltsblock innerhalb des Dokuments
  • Run: Ein Wrapper-Objekt, das TextContent enthält und auf das Stil angewendet werden kann
  • TextContent: Die eigentliche Textzeichenfolge

Hinzufügen von Inhalten zu Absätzen

IronWord bietet zwei Methoden zum Hinzufügen von Inhalten zu Absätzen:

  • AddText(TextContent): Verwenden Sie für unformatierten Klartext. Fügt TextContent direkt dem Absatz hinzu.
  • AddChild(Run): Verwenden Sie für formatierten Text. Fügt ein Run-Objekt (das TextContent umschließt und Stil erhält) dem Absatz hinzu.

Wenn Sie Stil wie Schriftgröße, Farbe oder fette Formatierung anwenden müssen, erstellen Sie ein Run-Objekt, weisen Sie ein TextStyle dem Run zu und verwenden Sie AddChild, um es dem Absatz hinzuzufügen.

TextRuns hinzufügen

Textinhalt

Die Split Methode wird verwendet, um die Textreihenfolge anhand eines angegebenen Trennzeichens in eine Liste kleinerer Textreihenfolgen zu unterteilen. Dies ermöglicht die Organisation und Manipulation von Textinformationen im Dokument.

using IronWord;
using IronWord.Models;

WordDocument doc = new WordDocument();

// Add text
TextContent addText = new TextContent("Add text using IronWord");
doc.AddParagraph(new Paragraph(addText));

// Append text
TextContent appendText = new TextContent("The first text.");
appendText.Append(new TextContent("The second text."));
doc.AddParagraph(new Paragraph(appendText));

// Split text
TextContent splitText = new TextContent("Use split to split the sentence.");
splitText.Split(" ");
doc.AddParagraph(new Paragraph(splitText));

// Export docx
doc.SaveAs("textrun.docx");

Stil festlegen

Um Stil für Text einzustellen, muss das Run Wrapper-Muster verwendet werden. Erstellen Sie ein Run-Objekt, das TextContent enthält, und weisen Sie dann ein TextStyle dem Run zu (nicht dem TextContent). Der TextStyle ermöglicht es Ihnen, visuelle Attribute wie FontSize, Farbe, fett, kursiv, durchgestrichen, unterstrichen, hochgestellt und tiefgestellt zu definieren.

Beachten Sie, dass FontSize auf Ebene des TextStyle konfiguriert wird, während FontFamily innerhalb der TextFont Eigenschaft gesetzt wird. Sobald Sie den Stil festgelegt haben, verwenden Sie AddChild, um das Run einem Absatz hinzuzufügen. Dies folgt der Dokumentenhierarchie: Document → Paragraph → Run → TextContent.

using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// Load docx
WordDocument doc = new WordDocument("document.docx");

// Configure text
Run textRun = new Run(new TextContent("Add text using IronWord"));
textRun.Style = new TextStyle()
{
    FontSize = 72,
    TextFont = new Font()
    {
        FontFamily = "Caveat"
    },
    Color = Color.Red,
    IsBold = true,
    IsItalic = true,
    Underline = new Underline(),
    Strike = StrikeValue.Strike,
};

Paragraph paragraph = new Paragraph();

// Add text
paragraph.AddChild(textRun);

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("save_document.docx");

Textfüllfarbe erhalten

Neben der Einstellung von Stil bietet IronWord eine Möglichkeit, den RGBA Farbwert aus vorhandenen Dokumenten zu erhalten, um im gesamten Stil Konsistenz zu wahren.

using IronWord;
using IronWord.Models;
using System;

// Open existing Word
WordDocument doc = new WordDocument("Accent1TextThemcolor.docx");

TextContent content = doc.Texts[0];

// This will show the R G B A of the themecolor
var filledColor = content.Color;

// Print the filled color variable to the console
Console.WriteLine(filledColor);

Um Farbwerte abzurufen, laden Sie das Dokument mit WordDocument und greifen Sie dann auf die Texts-Sammlung zu, um das TextContent-Objekt zu erhalten. Die Color-Eigenschaft von TextContent gibt den RGBA-Wert der vorhandenen Farbe des Textes zurück, was es Ihnen ermöglicht, durchgehend konsistente Stilsetzung in Ihrem Dokument zu wahren.

Bilder einbetten

Dieses Feature ermöglicht es Ihnen, Bilder in den Inhalt einzubeziehen, was die visuelle Gesamtwirkung und Ausdruckskraft des Dokuments verbessert.

using IronWord;
using IronWord.Models;

// Load docx
WordDocument doc = new WordDocument();

// Configure image
ImageContent image = new ImageContent("image.jpg");
image.Width = 200; // In unit pixel
image.Height = 200; // In unit pixel
TextContent textRun = new TextContent();

// Add image
Paragraph para = new Paragraph(textRun);
para.AddImage(image);

// Add paragraph
doc.AddParagraph(para);

// Export docx
doc.SaveAs("save_document.docx");

Bilder hinzufügen

Bild laden

Das Laden von Bildern ist ein entscheidender Prozess. Dies beinhaltet das Einbringen externer Bilddateien in das Dokument. Die Fähigkeit, Bilder zu laden, erleichtert die Einbeziehung relevanter visueller Elemente und trägt zu einem ansprechenderen und informativeren Dokument bei.

using IronWord;
using IronWord.Models;

// Load docx
WordDocument doc = new WordDocument();

Paragraph paragraph = new Paragraph();

// Add image
paragraph.AddImage("image.jpg");

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("document.docx");

Bild konfigurieren

Optimieren Sie die Bilder mit konfigurierbaren Einstellungen. Dies beinhaltet das Einstellen von Eigenschaften wie Abmessungen, Position und Abstand von den Ecken. Die richtige Konfiguration stellt sicher, dass Bilder auf eine visuell ansprechende und kontextuell angemessene Weise angezeigt werden.

Bitte beachten Sie: Bilder haben auch eine TextWrapBehavior-Eigenschaft (Typ ITextWrapBehavior) zur Steuerung des Textumbruchs um das Bild, aber derzeit ist keine öffentliche Implementierungsklasse oder Fabrik dokumentiert, um einen Wert zu konstruieren - dieses Beispiel wird weggelassen, bis die Bestätigung des Produktteams vorliegt.
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// Load docx
WordDocument doc = new WordDocument();

// Configure image
ImageContent image = new ImageContent("image.jpg");
image.Width = 100;
image.Height = 100;
image.DistanceFromTop = 50;

var position = new ElementPosition();
position.X = 50;
position.Y = 50;
image.Position = position;

Paragraph paragraph = new Paragraph();

// Add image
paragraph.AddImage(image);

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("document.docx");

Häufig gestellte Fragen

Für was wird IronWord in der C#-Entwicklung verwendet?

IronWord ist eine leistungsstarke Bibliothek für .NET C#-Entwickler, die dabei hilft, Word- und DOCX-Dokumente innerhalb ihrer Anwendungen zu erstellen, zu lesen und zu bearbeiten.

Wie kann ich formatierten Text einem Word-Dokument mit IronWord hinzufügen?

Sie können formatierten Text hinzufügen, indem Sie ein 'Run'-Objekt erstellen, das 'TextContent' umschließt, dann 'TextStyle' darauf anwenden und es mit der 'AddChild'-Methode in einem Absatz in IronWord hinzufügen.

Was ist der Zweck des 'Run'-Objekts in IronWord?

Das 'Run'-Objekt in IronWord fungiert als Wrapper für 'TextContent', das es ermöglicht, Text zu formatieren, wie z.B. die Schriftgröße, Farbe und andere Attribute festzulegen.

Wie betten Sie ein Bild mit IronWord in ein Dokument ein?

Um ein Bild einzubetten, erstellen Sie ein 'ImageContent'-Objekt und fügen es mit der 'AddImage'-Methode einem Absatz hinzu. Dies ermöglicht es Ihnen, Bilder in Ihr Dokument einzufügen.

Welche Schritte sind für die Konfiguration eines Bildes in IronWord erforderlich?

Die Konfiguration eines Bildes beinhaltet das Festlegen von Eigenschaften wie Abmessungen, Position und Abstand von Ecken, um sicherzustellen, dass das Bild korrekt im Dokument angezeigt wird.

Kann IronWord die Farbwerte aus einem vorhandenen Word-Dokument abrufen?

Ja, IronWord kann RGBA-Farbwerte aus vorhandenen Dokumenten über die 'Color'-Eigenschaft von 'TextContent' abrufen, um die Konsistenz der Formatierung zu gewährleisten.

Welche Methode verwendet IronWord, um einen Textrun zu teilen?

IronWord verwendet die 'Split'-Methode, um einen Textrun basierend auf einem angegebenen Trennzeichen in kleinere Runs zu unterteilen, um eine bessere Organisation und Manipulation des Textinhalts zu ermöglichen.

Warum ist das Verständnis der Dokumentenhierarchie in IronWord wichtig?

Das Verständnis der Dokumentenhierarchie (Dokument → Absatz → Run → TextContent) ist entscheidend, um Inhalte in einem Word-Dokument mit IronWord effektiv zu verwalten und zu gestalten.

Wie speichern Sie ein mit IronWord erstelltes Word-Dokument?

Ein mit IronWord erstelltes Word-Dokument kann mit der 'SaveAs'-Methode gespeichert werden, indem der Dateiname und Pfad zum Speichern des Dokuments angegeben werden.

Welche Funktion hat die 'AddParagraph'-Methode in IronWord?

Die 'AddParagraph'-Methode in IronWord dient dazu, vollständig konfigurierte Absätze mit Text und Bildern zu einem Word-Dokument hinzuzufügen.

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.

Mehr lesen

Bereit loszulegen?

NuGet-Downloads 62,392Version:2026.11gerade veröffentlicht