Hinzufügen von Stil zu Text in DOCX with C

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

Die IronWord-Klasse TextStyle ermöglicht es .NET Entwicklern, professionelle Textformatierungen programmatisch auf Word-Dokumente anzuwenden, 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

Wie füge ich einen Textstil zu DOCX hinzu?

Um Textstile in IronWord anzuwenden, muss das Wrapper-Muster Run verwendet werden. Erstellen Sie ein WordDocument-Objekt und anschließend ein Run-Objekt, das TextContent mit Ihrem Text enthält. Wenden Sie einen TextStyle auf den Run (nicht den TextContent) an, indem Sie Eigenschaften wie IsBold, Color oder FontSize verwenden.

Nach der Formatierung fügen Sie Run mithilfe von AddChild zu Paragraph hinzu, fügen den Absatz in das Dokument ein und speichern das Ergebnis. Dieser Ansatz folgt der Dokumenthierarchie (Dokument → Absatz → Lauf → Textinhalt) und ermöglicht die programmatische Steuerung der Textformatierung für automatisierte Dokumentgenerierungsszenarien, die eine einheitliche Formatierung erfordern.

: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");
$vbLabelText   $csharpLabel

Welche Ausgabe wird damit erzeugt?

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

Die Klasse TextStyle bietet grundlegende Formatierungsoptionen wie Schrifteigenschaften, Textfarbe, Fettdruck, Kursivschrift und Unterstreichung. Beachten Sie, dass FontSize auf der Ebene von TextStyle konfiguriert wird (nicht innerhalb von Font), während FontFamily in der Eigenschaft TextFont festgelegt wird. Das Objekt Run umschließt das Objekt TextContent und enthält den Stil gemäß dem Dokumenthierarchiemuster von IronWord. Das Beispiel veranschaulicht, wie mehrere Formatierungseigenschaften kombiniert werden, um einen reichhaltig 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 anhand vordefinierter Farben aus IronWord.Models.Color oder benutzerdefinierter Hexadezimalwerte 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");
$vbLabelText   $csharpLabel

Wie sieht farbiger Text aus?

Microsoft Word zeigt eine olivfarbene Textformatierung mit der Multifunktionsleiste der Registerkarte Home, die Schrift- und Absatzwerkzeuge anzeigt

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

Passen Sie die Textdarstellung mit der Eigenschaft TextFont an. Setzen Sie FontFamily auf einen beliebigen 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");
$vbLabelText   $csharpLabel

Wie sieht eine benutzerdefinierte Schriftart aus?

Microsoft Word zeigt die Schriftart Arial in 24pt in der Symbolleiste ausgewählt und einen formatierten Beispieltext an

Wie kann ich Text fett machen?

Setzen Sie die Eigenschaft IsBold auf true, um Text fett darzustellen. Fett gedruckter Text wird üblicherweise für Überschriften, Hervorhebungen oder zum Hervorheben wichtiger Informationen verwendet. In Kombination mit anderen Styling-Eigenschaften schafft fetter 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");
$vbLabelText   $csharpLabel

Wie sieht fetter Text aus?

Microsoft Word-Oberfläche mit fett formatiertem Text und der Aufschrift 'this is bold!' im Dokument

Wie kann ich Text kursiv machen?

Setzen Sie die Eigenschaft IsItalic auf true, um kursive Formatierung zu erreichen. Kursivschrift wird typischerweise zur Hervorhebung, für Titel, Fremdwörter oder Fachbegriffe verwendet. Diese subtile Formatierung hebt Textelemente hervor, ohne das visuelle Gewicht einer fetten 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");
$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` Wenn auf `true` gesetzt, wird der Text fett formatiert; wird häufig für Überschriften oder zur Hervorhebung verwendet. `textRun.Style.IsBold = true;`
`IsItalienisch` Wendet bei Einstellung auf `true` eine kursive Formatierung auf den Text an; wird typischerweise zur Hervorhebung oder für Überschriften verwendet. `textRun.Style.IsItalic = true;`
`Unterstreichen` Fügt dem Text eine Unterstreichung mit einem **`Unterstreichen`-Objekt** mit verschiedenen Unterstreichungsstilen hinzu. `textRun.Style.Underline = new Underline();`
`Strike` Durchstreichen von Text mit **`StrikeValue` enum** (Strike oder DoubleStrike). `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");
$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
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 36,374 | Version: 2026.3 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.