1. IronWord
  2. Anleitungen
  3. Text formatieren

How to Add Style to Text in DOCX with C

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

Die TextStyle-Klasse von IronWord ermöglicht es .NET-Entwicklern, Word-Dokumente programmgesteuert professionell zu formatieren, einschließlich Schriftarten, Farben, Fettdruck, Kursivschrift, Unterstreichung 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

  1. Installieren Sie IronWord mit NuGet Package Manager

    PM > Install-Package IronWord

  2. 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");

  3. Bereitstellen zum Testen in Ihrer Live-Umgebung

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

    arrow pointer

Minimaler Arbeitsablauf (5 Schritte)

  1. Installieren Sie die IronWord C# Bibliothek
  2. Erstellen Sie ein Run Objekt, TextContent enthält.
  3. Weisen Sie dem Run TextStyle mit Eigenschaften wie FontSize , IsBold und Farbe zu.
  4. Fügen Sie mit AddChild einen formatierten Run zu einem Paragraph hinzu.
  5. Speichern Sie das Dokument mit angewendeten Stilen

Wie füge ich einen Textstil zu DOCX hinzu?

Das Anwenden von Textstilen in IronWord erfordert die Verwendung des Wrapper-Musters Run. Erstellen Sie ein WordDocument-Objekt und anschließend ein Run-Objekt, das TextContent mit Ihrem Text enthält. Wenden Sie ein TextStyle auf das Run (nicht auf das TextContent) an, indem Sie Eigenschaften wie IsBold, Color oder FontSize.

Fügen Sie nach der Formatierung Run in ein Paragraph ein, indem Sie AddChild verwenden, 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.

Hinweis:Die Dokumenthierarchie von IronWord folgt der Struktur: Document → DocumentSection → Paragraph → Run → TextContent. Stile werden auf der Ebene Run 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, // No 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 ' No 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")
$vbLabelText   $csharpLabel

Welche Ausgabe wird damit erzeugt?

Microsoft Word-Oberfläche mit Layout-Ribbon und Dokument mit rot durchgestrichener Textformatierung

Die Klasse TextStyle bietet wichtige Formatierungsoptionen, darunter Schriftarteneigenschaften, Textfarbe, Fettdruck, Kursivschrift und Unterstreichung. Beachten Sie, dass FontSize auf der Ebene von TextStyle konfiguriert wird (nicht innerhalb von Font), während FontFamily innerhalb der Eigenschaft TextFont festgelegt wird. Das Run-Objekt umschließt das TextContent-Objekt und enthält den Stil, entsprechend dem Dokumenthierarchiemuster von IronWord. Das Beispiel zeigt, wie mehrere Formatierungseigenschaften zusammenwirken, um einen reich formatierten Text zu erzeugen, wenn sie auf ein Run angewendet werden.

Welche spezifischen Stile kann ich hinzufügen?

Wie kann ich die Textfarbe ändern?

Die Eigenschaft Color in TextStyle legt die Textfarbe mithilfe vordefinierter Farben aus IronWord.Models.Color oder benutzerdefinierter Hex-Werte fest. 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")
$vbLabelText   $csharpLabel

Wie sieht farbiger Text aus?

Microsoft Word mit olivfarbener Textformatierung und der Multifunktionsleiste der Registerkarte Home mit Schriftart- und Absatzwerkzeugen

Wie stelle ich Schriftfamilie und -größe ein?

Passen Sie die Darstellung des Textes mit der Eigenschaft TextFont an. Setzen Sie FontFamily auf einen beliebigen Namen einer installierten Schriftart (z. B. "Arial", "Times New Roman") und FontSize in Punkt. 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")
$vbLabelText   $csharpLabel

Wie sieht eine benutzerdefinierte Schriftart aus?

Microsoft Word mit der Schriftart Arial, 24pt, in der Symbolleiste ausgewählt und einem formatierten Beispieltext

Wie kann ich Text fett machen?

Setzen Sie die Eigenschaft IsBold auf true, um den Text Bold zu machen. Bold-Text wird häufig für Überschriften, Hervorhebungen oder zur Markierung wichtiger Informationen verwendet. In Kombination mit anderen Formatierungseigenschaften schafft Bold-Text eine 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")
$vbLabelText   $csharpLabel

Wie sieht fetter Text aus?

Microsoft Word-Oberfläche mit fett formatiertem Text und dem Hinweis

Wie kann ich Text kursiv machen?

Setzen Sie die Eigenschaft IsItalic auf true für das Italic-Styling. Italic-Text wird typischerweise zur Hervorhebung, für Titel, Fremdwörter oder Fachbegriffe verwendet. Diese subtile Formatierung unterscheidet Textelemente, ohne die visuelle Schwere der 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")
$vbLabelText   $csharpLabel

Wie sieht kursiver Text aus?

Word-Dokument mit kursivem Text und sichtbaren Formatierungsoptionen für die Registerkarte

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:

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,
    LineSpacing = new LineSpacing() { Value = 1.15 }  // Slightly increased line spacing
};

Paragraph bodyParagraph = new Paragraph();
bodyParagraph.AddChild(bodyRun);
doc.AddParagraph(bodyParagraph);

// Save the document
doc.SaveAs("professional-document.docx");
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,
    LineSpacing = new LineSpacing() { Value = 1.15 }  // Slightly increased line spacing
};

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,
    .LineSpacing = New LineSpacing() With {.Value = 1.15}  ' Slightly increased line spacing
}

Dim bodyParagraph As New Paragraph()
bodyParagraph.AddChild(bodyRun)
doc.AddParagraph(bodyParagraph)

' Save the document
doc.SaveAs("professional-document.docx")
$vbLabelText   $csharpLabel

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.

Ahmad Sohail
Ahmad Sohail
  Jetzt mit dem Ingenieurteam chatten
Full-Stack-Entwickler

Ahmad ist ein Full-Stack-Entwickler mit einer soliden Grundlage in C#, Python und Webtechnologien. Er hat ein großes Interesse am Aufbau skalierbarer Softwarelösungen und genießt es, zu erkunden, wie Design und Funktionalität in realen Anwendungen aufeinandertreffen.

Bevor er dem Iron Software Team beitrat, arbeitete ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 44,829 | Version: 2026.5 just released
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.