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 Dokumenthierarchie: Dokument → Absatz → Textabschnitt → Textinhalt . Das Verständnis dieser Hierarchie ist für die Arbeit mit formatiertem Text unerlässlich:

  • WordDocument: Der übergeordnete Container, der das gesamte Dokument repräsentiert
  • Paragraph: Ein Inhaltsblock innerhalb des Dokuments
  • Run: Ein Wrapper-Objekt, das TextContent enthält und dem Formatierungen zugewiesen werden können.
  • TextContent: Die eigentliche Textzeichenkette

Hinzufügen von Inhalten zu Absätzen

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

  • AddText(TextContent): Für unformatierten Klartext verwenden. Fügt TextContent direkt zum Absatz hinzu.
  • AddChild(Run): Für formatierten Text verwenden. Fügt dem Absatz ein Run-Objekt hinzu (das TextContent umschließt und die Formatierung enthält).

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

TextRuns hinzufügen

Textinhalt

Die Methode Split wird verwendet, um den Textabschnitt anhand eines festgelegten Trennzeichens in eine Liste kleinerer Textabschnitte 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

Um Text zu formatieren, muss das Wrapper-Muster Run verwendet werden. Erstelle ein Run-Objekt, das TextContent enthält, und weise dann ein TextStyle dem Run zu (nicht dem TextContent). Mit dem TextStyle können Sie visuelle Attribute wie FontSize, Farbe, Fettdruck, Kursivschrift, Durchstreichen, Unterstreichen, Hochstellung und Tiefstellung definieren.

Beachten Sie, dass FontSize auf der Ebene TextStyle konfiguriert wird, während FontFamily innerhalb der Eigenschaft TextFont festgelegt wird. Nach der Formatierung verwenden Sie AddChild, um Run zu einem Absatz hinzuzufügen. Dies folgt der Dokumenthierarchie: Dokument → Absatz → Textabschnitt → Textinhalt.

: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 der Möglichkeit, Formatierungen festzulegen, bietet IronWord auch die Möglichkeit, den RGBA-Farbwert aus bestehenden Dokumenten zu ermitteln, um die Konsistenz der Formatierung zu gewährleisten.

: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.Paragraphs[0].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.Paragraphs(0).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 und greifen Sie dann auf die Sammlung Paragraphs und das Array Texts zu, um das Objekt TextContent zu erhalten. Die Color-Eigenschaft von TextContent gibt den RGBA-Wert der vorhandenen Textfarbe zurück, sodass Sie eine einheitliche Formatierung im gesamten Dokument beibehalten können.

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(new Paragraph(textRun));

// Export docx
doc.SaveAs("save_document.docx");
Imports IronWord
Imports IronWord.Models

' Load docx
Private doc As New WordDocument()

' Configure image
Private 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(New Paragraph(textRun))

' 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;
using IronSoftware.Abstractions.Word;

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

// Configure image
ImageContent image = new ImageContent("image.jpg");
image.TextWrapBehavior = new TextWrapSquare();
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
Imports IronSoftware.Abstractions.Word

' Load docx
Dim doc As New WordDocument()

' Configure image
Dim image As New ImageContent("image.jpg")
image.TextWrapBehavior = New TextWrapSquare()
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.

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 38,043 | Version: 2026.4 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.