C# Document Element Tutorial
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 BildesHier 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.
-
1Install IronWord with NuGet Package Manager
-
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");C# -
3Bereitstellen zum Testen in Ihrer Live-Umgebung
Beginnen Sie noch heute, IronWord in Ihrem Projekt zu verwenden, mit einer kostenlosen Testversion
Inhaltsverzeichnis
- Text hinzufügen
- Textinhalt (Hinzufügen, Anhängen & Teilen)
- Stil festlegen (Schriftart & Größe, Farbe, Fett & Kursiv, Durchgestrichen, Unterstrichen, Hochgestellt & Tiefgestellt)
- Bilder einbetten
- Bilder hinzufügen
- Bild laden (Datei & FileStream)
- Textfluss festlegen
- Dimensionen festlegen (Breite & Höhe)
- Positionsversatz festlegen
- Abstand zu den Ecken festlegen
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 darstelltParagraph: Ein Inhaltsblock innerhalb des DokumentsRun: Ein Wrapper-Objekt, dasTextContententhält und auf das Stil angewendet werden kannTextContent: 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ügtTextContentdirekt in den Absatz ein.AddChild(Run): Verwenden Sie für formatierten Text. Fügt einRunObjekt (dasTextContentumschließ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.
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")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.
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")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.
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, 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.
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");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")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.
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
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.
How do you save a Word document created with IronWord?
A Word document created with IronWord can be saved using the 'SaveAs' method, specifying the filename and path for saving the document.
What is the function of the 'AddParagraph' method in IronWord?
The 'AddParagraph' method in IronWord is used to add fully configured paragraphs, with text and images, to a Word document.
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.
