1. IronWord
  2. Tutorials
  3. Dokumentelement
Wie man mit Dokumentenelementen in C# arbeitet

C# Document Element Tutorial

Curtis Chau
Curtis Chau
Aktualisiert:
This article was translated from English: Does it need improvement?
Translated
View the article in English

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

Hier erfahren Sie, wie Sie mit IronWord Rich Content hinzufügen können – indem Sie formatierten Text und ein eingebettetes Bild in ein Dokument kombinieren. Dieses Beispiel demonstriert das Run Wrapper-Muster für formatierten Text.

  1. Installieren Sie IronWord mit NuGet Package Manager

    PM > Install-Package IronWord

  2. Kopieren 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. Bereitstellen zum Testen in Ihrer Live-Umgebung

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

    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: Der eigentliche Textstring

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 in den Absatz ein.
  • AddChild(Run): Verwenden Sie für formatierten Text. Fügt ein Run Objekt (das TextContent umschließt und Stil enthält) in den Absatz ein.

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

TextRuns hinzufügen

Textinhalt

Die Split Methode wird verwendet, um den Textrun in eine Liste kleinerer Textruns basierend auf einem angegebenen Trennzeichen zu unterteilen. Dies ermöglicht die Organisation und Manipulation von Textinformationen im Dokument.

:path=/static-assets/word/content-code-examples/tutorials/add-textrun-text-content.cs
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");
Imports IronWord
Imports IronWord.Models

Private doc As New WordDocument()

' Add text
Private addText As New TextContent("Add text using IronWord")
doc.AddParagraph(New Paragraph(addText))

' Append text
Dim appendText As New TextContent("The first text.")
appendText.Append(New TextContent("The second text."))
doc.AddParagraph(New Paragraph(appendText))

' Split text
Dim splitText As New TextContent("Use split to split the sentence.")
splitText.Split(" ")
doc.AddParagraph(New Paragraph(splitText))

' Export docx
doc.SaveAs("textrun.docx")
$vbLabelText   $csharpLabel

Stil festlegen

Das Festlegen von Stil für Text erfordert die Verwendung des Run Wrapper-Musters. Erstellen Sie ein Run Objekt, das TextContent enthält, und weisen Sie TextStyle dem Run zu (nicht dem TextContent). Der TextStyle erlaubt es Ihnen, visuelle Attribute wie FontSize, Farbe, Fett, Kursiv, Durchgestrichen, Unterstrichen, Hochgestellt und Tiefgestellt zu definieren.

Beachten Sie, dass FontSize auf der TextStyle Ebene konfiguriert ist, während FontFamily innerhalb der TextFont Eigenschaft festgelegt wird. Sobald es formatiert ist, verwenden Sie AddChild, um Run zu einem Absatz hinzuzufügen. Dies folgt der Dokumentenhierarchie: Document → Paragraph → Run → TextContent.

:path=/static-assets/word/content-code-examples/tutorials/add-textrun-set-styling.cs
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");
Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

' Load docx
Dim doc As New WordDocument("document.docx")

' Configure text
Dim textRun As New Run(New TextContent("Add text using IronWord"))
textRun.Style = New TextStyle() With {
    .FontSize = 72,
    .TextFont = New Font() With {
        .FontFamily = "Caveat"
    },
    .Color = Color.Red,
    .IsBold = True,
    .IsItalic = True,
    .Underline = New Underline(),
    .Strike = StrikeValue.Strike
}

Dim paragraph As New Paragraph()

' Add text
paragraph.AddChild(textRun)

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("save_document.docx")
$vbLabelText   $csharpLabel

Textfüllfarbe erhalten

Neben dem Festlegen von Stil bietet Ihnen IronWord die Möglichkeit, den RGBA Farbwert aus vorhandenen Dokumenten zu erhalten, um Konsistenz im gesamten Stil beizubehalten.

:path=/static-assets/word/content-code-examples/tutorials/rgba-color-value.cs
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);
Imports IronWord
Imports IronWord.Models
Imports System

' Open existing Word
Dim doc As New WordDocument("Accent1TextThemcolor.docx")

Dim content As TextContent = doc.Texts(0)

' This will show the R G B A of the themecolor
Dim filledColor = content.Color

' Print the filled color variable to the console
Console.WriteLine(filledColor)
$vbLabelText   $csharpLabel

Um Farbwerte abzurufen, laden Sie das Dokument mit WordDocument, greifen Sie dann auf die Paragraphs Kollektion und das Texts Array zu, um das TextContent Objekt zu erhalten. Die Color Eigenschaft von TextContent gibt den RGBA Wert der vorhandenen Farbe des Textes zurück und ermöglicht es Ihnen, einen konsistenten Stil im gesamten Dokument beizubehalten.

Bilder einbetten

Diese Funktion ermöglicht es Ihnen, nahtlos Bilder in den Inhalt einzuschließen, was die gesamte visuelle Attraktivität und Ausdruckskraft des Dokuments erhöht.

:path=/static-assets/word/content-code-examples/tutorials/add-textrun-embed-images.cs
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");
Imports IronWord
Imports IronWord.Models

' Load docx
Dim doc As New WordDocument()

' Configure image
Dim image As New ImageContent("image.jpg")
image.Width = 200 ' In unit pixel
image.Height = 200 ' In unit pixel
Dim textRun As New TextContent()

' Add image
Dim para As New Paragraph(textRun)
para.AddImage(image)

' Add paragraph
doc.AddParagraph(para)

' Export docx
doc.SaveAs("save_document.docx")
$vbLabelText   $csharpLabel

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.

:path=/static-assets/word/content-code-examples/tutorials/add-image-load-image.cs
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");
Imports IronWord
Imports IronWord.Models

' Load docx
Private doc As New WordDocument()

Private paragraph As New Paragraph()

' Add image
paragraph.AddImage("image.jpg")

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("document.docx")
$vbLabelText   $csharpLabel

Bild konfigurieren

Optimieren Sie die Bilder mit konfigurierbaren Einstellungen. Dazu gehört das Festlegen von Eigenschaften wie Textfluss, Dimensionen, Position und Abstand zu den Ecken. Die richtige Konfiguration stellt sicher, dass Bilder auf eine visuell ansprechende und kontextuell angemessene Weise angezeigt werden.

:path=/static-assets/word/content-code-examples/tutorials/add-image-configure-image.cs
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");
Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

' Load docx
Dim doc As New WordDocument()

' Configure image
Dim image As New ImageContent("image.jpg")
image.Width = 100
image.Height = 100
image.DistanceFromTop = 50

Dim position As New ElementPosition()
position.X = 50
position.Y = 50
image.Position = position

Dim paragraph As New Paragraph()

' Add image
paragraph.AddImage(image)

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("document.docx")
$vbLabelText   $csharpLabel

Häufig gestellte Fragen

Wie kann ich Text zu einem Word-Dokument mit C# hinzufügen?

Sie können Text zu einem Word-Dokument hinzufügen, indem Sie mit IronWord eine Instanz eines Textlaufs erstellen, der dann einem Absatz im Dokument angehängt werden kann.

Was ist die Methode, um Text in einem Word-Dokument zu teilen?

IronWord bietet die Split-Methode, die es Ihnen ermöglicht, einen Textlauf basierend auf einem angegebenen Trennzeichen in kleinere Segmente zu teilen, um die Textmanipulation zu erleichtern.

Wie style ich Text in einem Word-Dokument mit IronWord?

Sie können Text mit IronWord gestalten, indem Sie verschiedene Attribute wie Schriftgröße, Farbe und Stile wie fett, kursiv, durchgestrichen, unterstrichen, hochgestellt und tiefgestellt festlegen.

Wie kann ich Bilder in ein Word-Dokument mit C# einbetten?

Um Bilder in ein Word-Dokument mit IronWord einzubetten, können Sie ein Bild aus einer Datei laden und es als Inline-Bild einem Absatz innerhalb des Dokuments hinzufügen.

Welche Schritte sind beim Laden eines Bildes in ein Word-Dokument erforderlich?

Mit IronWord können Sie ein Bild entweder aus einer Datei oder einem Dateistream laden und so visuelle Inhalte in ein Word-Dokument einfügen.

Wie konfiguriere ich Bildeigenschaften in einem Word-Dokument?

Mit IronWord können Sie Bildeigenschaften wie Textumbruch, Dimensionen, Positionsoffset und Distanz von Ecken konfigurieren, um die korrekte Bildanzeige im Dokument zu gewährleisten.

Kann ich den RGBA-Farbwert von Text in einem Word-Dokument abrufen?

Ja, IronWord ermöglicht es Ihnen, den RGBA-Farbwert von bestehendem Text in einem Dokument abzurufen, um eine konsistente Gestaltung beizubehalten.

Wie kann ich IronWord für die Manipulation von Word-Dokumenten verwenden?

Um mit IronWord zu beginnen, können Sie es in Ihre .NET C#-Anwendung integrieren, um Word-Dokumente zu erstellen, zu lesen und zu bearbeiten und die umfassenden Bibliotheksfunktionen zu nutzen.

Welche Art von Unterstützung bietet Iron Software für IronWord?

Iron Software bietet umfassenden Support für IronWord, einschließlich Dokumentation, Tutorials und Kundensupport, um Entwicklern bei der Implementierung zu helfen.

Gibt es eine kostenlose Testversion für IronWord?

Ja, Iron Software bietet eine kostenlose Testversion von IronWord an, die Entwicklern ermöglicht, seine Funktionen und Fähigkeiten zu erkunden, bevor sie eine Kaufentscheidung treffen.

Curtis Chau
Curtis Chau
  Jetzt mit dem Ingenieurteam chatten
Technischer Autor

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

Weiterlesen
Bereit anzufangen?
Nuget Downloads 48,355 | Version: 2026.7 gerade veröffentlicht
Still Scrolling Icon

Scrollst du immer noch?

Sie brauchen schnell einen Beweis? PM > Install-Package IronWord
Führen Sie ein Beispiel aus und sehen Sie zu, wie aus Ihren Daten ein Word-Dokument wird.