How to Add Style to Text in DOCX with C
Die TextStyle Klasse von IronWord ermöglicht .NET-Entwicklern, professionelle Textformatierungen programmgesteuert auf Word-Dokumente anzuwenden, einschließlich Schriftarten, Farben, fett, kursiv, unterstrichen und mehr. IronWord bietet umfassende Styling-Tools, die die Formatierungsoptionen von Microsoft Word nachbilden, ganz gleich, ob es sich um die Erstellung von Berichten, Vorlagen oder die Automatisierung der Dokumentenerstellung handelt.
Schnellstart: Text in DOCX mit C# formatieren
-
Installieren Sie IronWord mit NuGet Package Manager
-
Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.
// Quick example using IronWord; using IronWord.Models; // Initialize a new Word document WordDocument doc = new WordDocument(); // Create a Run with styled text Run textRun = new Run(new TextContent("Styled text")); // Apply styling properties to the Run textRun.Style = new TextStyle() { IsBold = true, Color = Color.Red, FontSize = 16, TextFont = new Font() { FontFamily = "Arial" } }; // Create paragraph and add the styled Run Paragraph paragraph = new Paragraph(); paragraph.AddChild(textRun); // Add paragraph to document and save doc.AddParagraph(paragraph); doc.SaveAs("styled.docx"); -
Bereitstellen zum Testen in Ihrer Live-Umgebung
Beginnen Sie noch heute, IronWord in Ihrem Projekt zu verwenden, mit einer kostenlosen Testversion
Minimaler Arbeitsablauf (5 Schritte)
- Installieren Sie die IronWord C# Bibliothek
- Erstellen Sie ein
RunObjekt,TextContententhält. - Weisen Sie dem
RunTextStylemit Eigenschaften wieFontSize,IsBoldundFarbezu. - Fügen Sie mit
AddChildeinen formatiertenRunzu einemParagraphhinzu. - Speichern Sie das Dokument mit angewendeten Stilen
Wie füge ich einen Textstil zu DOCX hinzu?
Für die Anwendung von Textstilen in IronWord muss das Run Wrapper-Muster verwendet werden. Erstellen Sie ein WordDocument Objekt, dann ein Run Objekt, das TextContent mit Ihrem Text enthält. Wenden Sie eine TextStyle auf den Run (nicht auf den TextContent) mit Eigenschaften wie IsBold, Color oder FontSize an.
Sobald der Stil angewendet ist, fügen Sie den Run zu einem Paragraph mit AddChild hinzu, fügen Sie den Absatz in das Dokument ein und speichern Sie das Ergebnis. Dieser Ansatz bietet programmatische Kontrolle über die Textformatierung für automatisierte Szenarien der Dokumentenerstellung, die ein einheitliches Styling erfordern.
Document → DocumentSection → Paragraph → Run → TextContent. Stile werden auf der Run Ebene angewendet, nicht direkt auf TextContent.:path=/static-assets/word/content-code-examples/how-to/add-style-text-simple.cs
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;
// Load docx
WordDocument doc = new WordDocument("sample.docx");
// Configure text
Run textRun = new Run(new TextContent("Add text using IronWord"));
// Configure text style settings
textRun.Style = new TextStyle()
{
FontSize = 24, // Text Size is 24
TextFont = new Font()
{
FontFamily = "Calibri" // Text Font is "Calibri"
},
Color = Color.Red, // Set text color to red
IsBold = true, // Make text bold
IsItalic = true, // Make text italic
Underline = new Underline(), // Have an underline
Strike = StrikeValue.DoubleStrike, // Double strike-through
};
Paragraph paragraph = new Paragraph();
// Add text to paragraph
paragraph.AddChild(textRun);
// Add paragraph to document
doc.AddParagraph(paragraph);
// Save document
doc.SaveAs("add-text-style.docx");
Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums
' Load docx
Dim doc As New WordDocument("sample.docx")
' Configure text
Dim textRun As New Run(New TextContent("Add text using IronWord"))
' Configure text style settings
textRun.Style = New TextStyle() With {
.FontSize = 24, ' Text Size is 24
.TextFont = New Font() With {
.FontFamily = "Calibri" ' Text Font is "Calibri"
},
.Color = Color.Red, ' Set text color to red
.IsBold = True, ' Make text bold
.IsItalic = True, ' Make text italic
.Underline = New Underline(), ' Have an underline
.Strike = StrikeValue.DoubleStrike ' Double strike-through
}
Dim paragraph As New Paragraph()
' Add text to paragraph
paragraph.AddChild(textRun)
' Add paragraph to document
doc.AddParagraph(paragraph)
' Save document
doc.SaveAs("add-text-style.docx")
Welche Ausgabe wird damit erzeugt?
Die TextStyle Klasse bietet wesentliche Formatierungsoptionen einschließlich Schriftarteigenschaften, Textfarbe, fett, kursiv und unterstrichen. Beachten Sie, dass FontSize auf der TextStyle Ebene (nicht innerhalb von Font) konfiguriert wird, während FontFamily innerhalb der TextFont Eigenschaft festgelegt wird. Das Run Objekt umschließt das TextContent und hält den Stil, gemäß dem Dokumentenhierarchiemuster von IronWord. Das Beispiel zeigt, wie mehrere Stileigenschaften kombiniert werden, um reichhaltig formatierten Text zu erzeugen, wenn sie auf einen Run angewendet werden.
Welche spezifischen Stile kann ich hinzufügen?
Wie kann ich die Textfarbe ändern?
Die Color Eigenschaft in TextStyle legt die Textfarbe fest, wobei vordefinierte Farben von IronWord.Models.Color oder benutzerdefinierte Hex-Werte verwendet werden. Dadurch werden bestimmte Inhalte hervorgehoben oder die Markenfarben angepasst. IronWord unterstützt eine breite Palette von Farben, darunter Rot, Blau, Grün, Oliv, Navy und Maroon.
:path=/static-assets/word/content-code-examples/how-to/add-style-text-add-text.cs
using IronWord;
using IronWord.Models;
// Create document
WordDocument doc = new WordDocument();
// Add colored text
Run textRun = new Run(new TextContent("This text is olive-colored!"));
textRun.Style = new TextStyle()
{
Color = IronWord.Models.Color.Olive // defining text to be colored olive
};
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);
// Save document
doc.SaveAs("colored-text.docx");
Imports IronWord
Imports IronWord.Models
' Create document
Dim doc As New WordDocument()
' Add colored text
Dim textRun As New Run(New TextContent("This text is olive-colored!"))
textRun.Style = New TextStyle() With {
.Color = IronWord.Models.Color.Olive ' defining text to be colored olive
}
Dim paragraph As New Paragraph()
paragraph.AddChild(textRun)
doc.AddParagraph(paragraph)
' Save document
doc.SaveAs("colored-text.docx")
Wie sieht farbiger Text aus?
Wie stelle ich Schriftfamilie und -größe ein?
Passen Sie das Textaussehen mit der TextFont Eigenschaft an. Setzen Sie FontFamily auf jeden installierten Schriftartnamen (z.B. "Arial", "Times New Roman") und FontSize in Punkten. Dadurch wird eine visuelle Hierarchie geschaffen und die Lesbarkeit auf verschiedenen Geräten und Plattformen gewährleistet.
:path=/static-assets/word/content-code-examples/how-to/add-style-text-add-font.cs
using IronWord;
using IronWord.Models;
// Create document
WordDocument doc = new WordDocument();
// Add text with custom font family and size
Run textRun = new Run(new TextContent("This text uses Arial at 24pt!"));
textRun.Style = new TextStyle()
{
FontSize = 24, // Set font size in points
TextFont = new IronWord.Models.Font()
{
FontFamily = "Arial" // Set font family
}
};
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);
// Save document
doc.SaveAs("font-styled-text.docx");
Imports IronWord
Imports IronWord.Models
' Create document
Dim doc As New WordDocument()
' Add text with custom font family and size
Dim textRun As New Run(New TextContent("This text uses Arial at 24pt!"))
textRun.Style = New TextStyle() With {
.FontSize = 24, ' Set font size in points
.TextFont = New IronWord.Models.Font() With {
.FontFamily = "Arial" ' Set font family
}
}
Dim paragraph As New Paragraph()
paragraph.AddChild(textRun)
doc.AddParagraph(paragraph)
' Save document
doc.SaveAs("font-styled-text.docx")
Wie sieht eine benutzerdefinierte Schriftart aus?
Wie kann ich Text fett machen?
Setzen Sie die IsBold Eigenschaft auf true, um den Text Bold zu machen. Bold Text wird häufig für Überschriften, Hervorhebungen oder das Betonen wichtiger Informationen verwendet. Kombiniert mit anderen Stileigenschaften erstellt Bold Text visuelle Hierarchie und verbessert die Lesbarkeit.
:path=/static-assets/word/content-code-examples/how-to/add-style-text-add-bold.cs
using IronWord;
using IronWord.Models;
// Create document
WordDocument doc = new WordDocument();
// Add bold text
Run textRun = new Run(new TextContent("this is bold!"));
textRun.Style = new TextStyle()
{
IsBold = true // Make text bold
};
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);
// Save document
doc.SaveAs("bold-text.docx");
Imports IronWord
Imports IronWord.Models
' Create document
Dim doc As New WordDocument()
' Add bold text
Dim textRun As New Run(New TextContent("this is bold!"))
textRun.Style = New TextStyle() With {
.IsBold = True ' Make text bold
}
Dim paragraph As New Paragraph()
paragraph.AddChild(textRun)
doc.AddParagraph(paragraph)
' Save document
doc.SaveAs("bold-text.docx")
Wie sieht fetter Text aus?
Wie kann ich Text kursiv machen?
Setzen Sie die IsItalic Eigenschaft auf true für Italic Stil. Italic Text wird typischerweise für Hervorhebungen, Titel, Fremdwörter oder technische Begriffe verwendet. Diese subtile Formatierung differenziert Textelemente ohne das visuelle Gewicht einer Bold Formatierung.
:path=/static-assets/word/content-code-examples/how-to/add-style-text-add-italic.cs
using IronWord;
using IronWord.Models;
// Create document
WordDocument doc = new WordDocument();
// Add italic text
Run textRun = new Run(new TextContent("this is italic."));
textRun.Style = new TextStyle()
{
IsItalic = true // Make text italic
};
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
doc.AddParagraph(paragraph);
// Save document
doc.SaveAs("italic-text.docx");
Imports IronWord
Imports IronWord.Models
' Create document
Dim doc As New WordDocument()
' Add italic text
Dim textRun As New Run(New TextContent("this is italic."))
textRun.Style = New TextStyle() With {
.IsItalic = True ' Make text italic
}
Dim paragraph As New Paragraph()
paragraph.AddChild(textRun)
doc.AddParagraph(paragraph)
' Save document
doc.SaveAs("italic-text.docx")
Wie sieht kursiver Text aus?
Was sind die verfügbaren Styling-Eigenschaften?
IronWord bietet umfassende Styling-Eigenschaften, die die Formatierungsoptionen von Microsoft Word widerspiegeln. Diese Eigenschaften führen zu einer komplexen Textformatierung, die professionellen Dokumentenstandards entspricht.
| Styling-Methode | Beschreibung | Beispiel |
|---|---|---|
TextFont |
Passt die Textdarstellung mithilfe eines Font Objekts an und legt die Schriftart fest. Hinweis: FontSize wird auf der Ebene TextStyle und nicht innerhalb Font festgelegt. |
textRun.Style = new TextStyle() { FontSize = 24, TextFont = new Font() { FontFamily = "Calibri" } }; |
Farbe |
Legt die Textfarbe mit vordefinierten Farben aus IronWord.Models.Color oder benutzerdefinierten Hex-Werten fest. | textRun.Style.Color = IronWord.Models.Color.Red; |
IsBold |
Macht Text Fett, wenn auf true gesetzt, und wird häufig für Überschriften oder Hervorhebungen verwendet. |
textRun.Style.IsBold = true; |
IsItalienisch |
Wendet Kursiv-Stil auf Text an, wenn auf true gesetzt, typischerweise für Hervorhebungen oder Titel. |
textRun.Style.IsItalic = true; |
Unterstreichen |
Fügt dem Text eine Unterstreichung mit einem Unterstreichen-Objekt mit verschiedenen Unterstreichungsstilen hinzu. |
textRun.Style.Underline = new Underline(); |
Strich |
Wendet einen Durchstreichungseffekt auf Text mit dem StrikeValue-Enum (Strich oder DoubleStrike) an. |
textRun.Style.Strike = StrikeValue.Strike; |
Kappen |
Wendet Großschreibeffekte auf den Text an und konvertiert alle Zeichen in Großbuchstaben. | textRun.Style.Caps = true; |
ZeichenSkala |
Passt die proportionale Breite von Zeichen als Prozentsatz ihrer normalen Größe an. | textRun.Style.CharacterScale = 150; |
Emboss |
Wendet einen Prägeeffekt auf Text an, der ein erhabenes Aussehen erzeugt. | textRun.Style.Emboss = true; |
Schwerpunkt |
Fügt Betonungszeichen zu gestyltem Text mit EmphasisMarkValues enum-Werten hinzu. |
textRun.Style.Emphasis = EmphasisMarkValues.Dot; |
Zeilenabstand |
Steuert die Abstände zwischen den Textzeilen für eine bessere Lesbarkeit mit einem Zeilenabstand-Objekt. |
textRun.Style.LineSpacing = new LineSpacing() { Value = 1.5 }; |
Übersicht |
Gibt den Text mit einem Umriss-Effekt wieder, wobei nur die Zeichenränder angezeigt werden. | textRun.Style.Outline = true; |
Schatten |
Wendet Hintergrundfarbe oder Schattierung auf Text mit einem Schattierung-Objekt an. |
textRun.Style.Shading = new Shading() { Color = Color.Yellow }; |
Kleinbuchstaben |
Konvertiert Kleinbuchstaben in kleine Großbuchstaben, wobei die Groß-/Kleinschreibung beibehalten wird. | textRun.Style.SmallCaps = true; |
VertikalePosition |
Passt die vertikale Platzierung von Text relativ zu seiner Grundlinie an, gemessen in Punkten. | textRun.Style.VerticalPosition = 5.0; |
VertikalesTextAlignment |
Positioniert Text vertikal innerhalb seines Containers mit VerticalPositionValues enum. |
textRun.Style.VerticalTextAlignment = VerticalPositionValues.Superscript; |
Kombinieren mehrerer Stile
Die Stärke von IronWord bei der Textgestaltung ergibt sich aus der Kombination mehrerer Eigenschaften zur Erzielung komplexer Formatierungen. Hier ein Beispiel für professionell gestylten Text durch die Kombination verschiedener Styling-Eigenschaften:
:path=/static-assets/word/content-code-examples/how-to/add-style-text-7.cs
using IronWord;
using IronWord.Models;
// Create a new document
WordDocument doc = new WordDocument();
// Create richly formatted header text using Run
Run headerRun = new Run(new TextContent("Professional Document Header"));
headerRun.Style = new TextStyle()
{
FontSize = 28,
TextFont = new Font()
{
FontFamily = "Georgia"
},
Color = Color.DarkBlue,
IsBold = true,
SmallCaps = true,
Underline = new Underline(),
CharacterScale = 110, // Slightly expand character width
Shading = new Shading()
{
Color = Color.LightGray // Light background
}
};
// Add header to document using AddChild for styled Run
Paragraph headerParagraph = new Paragraph();
headerParagraph.AddChild(headerRun);
doc.AddParagraph(headerParagraph);
// Create body text with different styling
Run bodyRun = new Run(new TextContent("This is professionally formatted body text with custom styling."));
bodyRun.Style = new TextStyle()
{
FontSize = 11,
TextFont = new Font()
{
FontFamily = "Calibri"
},
Color = Color.Black
};
Paragraph bodyParagraph = new Paragraph();
bodyParagraph.AddChild(bodyRun);
doc.AddParagraph(bodyParagraph);
// Save the document
doc.SaveAs("professional-document.docx");
Imports IronWord
Imports IronWord.Models
' Create a new document
Dim doc As New WordDocument()
' Create richly formatted header text using Run
Dim headerRun As New Run(New TextContent("Professional Document Header"))
headerRun.Style = New TextStyle() With {
.FontSize = 28,
.TextFont = New Font() With {
.FontFamily = "Georgia"
},
.Color = Color.DarkBlue,
.IsBold = True,
.SmallCaps = True,
.Underline = New Underline(),
.CharacterScale = 110, ' Slightly expand character width
.Shading = New Shading() With {
.Color = Color.LightGray ' Light background
}
}
' Add header to document using AddChild for styled Run
Dim headerParagraph As New Paragraph()
headerParagraph.AddChild(headerRun)
doc.AddParagraph(headerParagraph)
' Create body text with different styling
Dim bodyRun As New Run(New TextContent("This is professionally formatted body text with custom styling."))
bodyRun.Style = New TextStyle() With {
.FontSize = 11,
.TextFont = New Font() With {
.FontFamily = "Calibri"
},
.Color = Color.Black
}
Dim bodyParagraph As New Paragraph()
bodyParagraph.AddChild(bodyRun)
doc.AddParagraph(bodyParagraph)
' Save the document
doc.SaveAs("professional-document.docx")
Mit diesem umfassenden Styling-Ansatz werden Dokumente erstellt, die ein konsistentes Branding und ein professionelles Erscheinungsbild während des gesamten Prozesses der Dokumentenerstellung Ihrer Anwendung aufweisen.
Häufig gestellte Fragen
Wie wende ich in C# programmgesteuert Textformatierungen auf Word-Dokumente an?
Mit der TextStyle-Klasse von IronWord können Sie professionelle Textformatierungen wie Schriftarten, Farben, fett, kursiv und unterstrichen anwenden. Erstellen Sie einfach ein TextContent-Objekt mit Ihrem Text, wenden Sie einen TextStyle mit den gewünschten Eigenschaften an, fügen Sie ihn zu einem Absatz hinzu und speichern Sie das Dokument.
Was sind die grundlegenden Schritte zur Formatierung von Text in DOCX-Dateien?
So gestalten Sie Text mit IronWord: 1) Installieren Sie IronWord über NuGet, 2) Erstellen Sie ein WordDocument-Objekt, 3) Erstellen Sie TextContent mit Ihrem Text, 4) Wenden Sie TextStyle-Eigenschaften wie Schriftart, Farbe oder Fettdruck an, 5) Fügen Sie den Text zu einem Absatz hinzu und speichern Sie.
Welche Textformatierungsoptionen sind verfügbar?
Die TextStyle-Klasse von IronWord bietet wichtige Formatierungsoptionen, darunter Schrifteigenschaften (FontFamily und FontSize), Textfarbe, fett, kursiv, unterstrichen und durchgestrichen. Diese Optionen können kombiniert werden, um reichhaltig formatierten Text zu erstellen.
Wie ändere ich die Schriftfamilie und die Größe des Textes?
Verwenden Sie die Eigenschaft TextFont in TextStyle, um Schriftfamilie und -größe festzulegen. Setzen Sie die FontFamily auf Schriftarten wie "Arial" oder "Times New Roman" und FontSize auf die gewünschte Punktgröße, z. B. 16 für größeren Text.
Kann ich mehrere Textstile gleichzeitig anwenden?
Ja, IronWord ermöglicht es Ihnen, mehrere Stileigenschaften in einem einzigen TextStyle-Objekt zu kombinieren. Sie können Fett-, Kursiv-, Farb- und Schriftänderungen auf einmal anwenden, um komplexe Textformatierungen zu erstellen.
Wie kann ich die Textfarbe in Word-Dokumenten mit C# ändern?
Mit der Eigenschaft Color in IronWord's TextStyle können Sie die Textfarbe mithilfe von vordefinierten Farben aus IronWord.Models.Color oder benutzerdefinierten Hex-Werten festlegen. Mit dieser Funktion können Sie bestimmte Inhalte hervorheben oder Markenfarben in Ihren Dokumenten anpassen.

