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

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.

als-Überschrift:2(Schnellstart: Erstellen Sie einen gestylten TextRun und betten Sie ein Bild in einem Schritt ein)

Hier erfahren Sie, wie Sie mit IronWord schnell reichhaltige Inhalte hinzufügen können – gestylten Text und ein eingebettetes Bild in einem einzigen Absatz kombinieren und das Dokument in nur einem einzigen fließenden Codeblock speichern. Perfekt für Entwickler, die sofort ohne Standard-Code beginnen möchten.

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronWord with NuGet Package Manager

    PM > Install-Package IronWord

  2. Copy and run this code snippet.

    new WordDocument()
  .AddParagraph(new Paragraph(new TextContent("Hello IronWord!")).AddImage(new ImageContent("pic.png")))
  .SaveAs("output.docx");

  3. Deploy to test on your live environment

    Start using IronWord in your project today with a free trial
    arrow pointer

Inhaltsverzeichnis

TextRuns hinzufügen

Textinhalt

Die Split-Methode wird verwendet, um den Textrun basierend auf einem angegebenen Trennzeichen in eine Liste kleinerer TextRuns aufzuteilen. 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 des Stylings für TextRuns ermöglicht es Ihnen, die visuelle Präsentation des Textes zu definieren. Dazu gehört das Festlegen von Attributen wie Schriftgröße, Farbe, Stil, Durchgestrichen, Unterstrichen, Hochgestellt und Tiefgestellt. Das Konfigurieren des Stylings verbessert das gesamte Erscheinungsbild des Textes im Dokument.

: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
TextContent textRun = new TextContent();
textRun.Text = "Add text using IronWord";
textRun.Style = new TextStyle()
{
    TextFont = new Font()
    {
        FontFamily = "Caveat",
        FontSize = 72,
    },
    Color = Color.Red,
    IsBold = true,
    IsItalic = true,
    Underline = new Underline(),
    Strike = StrikeValue.Strike,
};

Paragraph paragraph = new Paragraph();

// Add text
paragraph.AddText(textRun);

// Add paragraph
doc.AddParagraph(paragraph);

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

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

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

Dim paragraph As New Paragraph()

' Add text
paragraph.AddText(textRun)

' Add paragraph
doc.AddParagraph(paragraph)

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

Textfüllfarbe erhalten

Abgesehen von der Stilfestlegung bietet IronWord Ihnen eine Möglichkeit, den RGBA-Farbwert des vorhandenen Dokuments zu erhalten, um Konsistenz im Styling 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.Paragraphs[0].Texts[0];

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

// Print the filled color variable to the console
Console.WriteLine(filledColor);
Imports IronWord
Imports IronWord.Models
Imports System

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

Private content As TextContent = doc.Paragraphs(0).Texts(0)

' This will show the R G B A of the themecolor
Private filledColor = content.FillColor

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

Zuerst importieren wir das Dokument, indem wir ein neues WordDocument initialisieren, greifen dann auf das Paragraphs-Array und das Texts-Array zu, um die Text-Eigenschaft abzurufen. Die Text-Klasse gibt dann die FillColor zurück, um den RGBA-Wert der vorhandenen Farbe des Textes anzuzeigen.

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;

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

// Configure image
ImageContent image = new ImageContent("image.jpg");
image.WrapText = WrapText.Square;
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
Private doc As New WordDocument()

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

Dim position = 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 mit IronWord für die Bearbeitung von Word-Dokumenten beginnen?

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 25,807 | Version: 2025.11 gerade veröffentlicht