1. IronWord
  2. Poradniki
  3. Dodaj styl do tekstu

How to Add Style to Text in DOCX with C

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

Klasa TextStyle IronWord umożliwia deweloperom .NET na programistyczne stosowanie profesjonalnego formatowania tekstu w dokumentach Word, obejmującego czcionki, kolory, pogrubienie, kursywę, podkreślenie i inne. Niezależnie od tego, czy generujesz raporty, tworzysz szablony czy automatyzujesz tworzenie dokumentów, IronWord oferuje kompleksowe narzędzia stylizacji odzwierciedlające opcje formatowania Microsoft Word.

Szybki start: Stylizacja tekstu w DOCX za pomocą C#

  1. Install IronWord with NuGet Package Manager

    PM > Install-Package IronWord

  2. Skopiuj i uruchom ten fragment kodu.

    // 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. Wdrożenie do testowania w środowisku produkcyjnym

    Rozpocznij używanie IronWord w swoim projekcie już dziś z darmową wersją próbną

    arrow pointer

Minimalny proces (5 kroków)

  1. Zainstaluj bibliotekę IronWord dla C#
  2. Utwórz obiekt Run zawierający TextContent
  3. Zastosuj TextStyle do obiektu Run z właściwościami takimi jak FontSize, IsBold, Color
  4. Dodaj ostylowany obiekt Run do Paragraph za pomocą AddChild
  5. Zapisz dokument z zastosowanymi stylami

Jak dodać styl tekstu do DOCX?

Stosowanie stylów tekstu w IronWord wymaga użycia wzorca opakowania Run. Utwórz obiekt WordDocument, następnie utwórz obiekt Run zawierający TextContent wraz z twoim tekstem. Zastosuj TextStyle do Run (nie do TextContent) korzystając z właściwości takich jak IsBold, Color lub FontSize.

Po ostylowaniu dodaj Run do Paragraph za pomocą AddChild, wstaw paragraf do dokumentu i zapisz wynik. Takie podejście zapewnia programową kontrolę nad formatowaniem tekstu w scenariuszach automatycznego generowania dokumentów wymagających spójnego stylu.

Zwróć uwagęHierarchia dokumentów w IronWord ma następującą strukturę: Dokument → Sekcja dokumentu → Akapit → Fragment → Treść tekstowa. Style są stosowane na poziomie Run, a nie bezpośrednio w 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

Jaki będzie wynik tego zadania?

Interfejs programu WORD z wstążką Układ i dokumentem z formatowaniem tekstu z czerwonym przekreśleniem

Klasa TextStyle oferuje podstawowe opcje formatowania, w tym właściwości czcionki, kolor tekstu, pogrubienie, kursywę i podkreślenie. Pamiętaj, że FontSize jest konfigurowane na poziomie TextStyle (nie wewnątrz Font), zaś FontFamily jest ustawiane w ramach właściwości TextFont. Obiekt Run opakowuje TextContent i przechowuje styl, zgodnie z hierarchią dokumentów IronWord. Przykład pokazuje, jak wiele właściwości stylizacji łączy się, aby stworzyć bogato sformatowany tekst, gdy jest stosowany do Run.

Jakie konkretne style mogę dodać?

Jak zmienić kolor tekstu?

Właściwość Color w TextStyle ustawia kolor tekstu za pomocą zdefiniowanych kolorów z IronWord.Models.Color lub niestandardowych wartości szesnastkowych. Podkreśla to konkretną treść lub pasuje do kolorów marki. IronWord obsługuje szeroką gamę kolorów, w tym czerwony, niebieski, zielony, oliwkowy, granatowy i bordowy.

: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

Jak wygląda tekst w kolorze?

Program WORD z formatowaniem tekstu w kolorze oliwkowym oraz wstążką zakładki

Jak ustawić rodzinę czcionek i rozmiar?

Dostosuj wygląd tekstu za pomocą właściwości TextFont. Ustaw FontFamily na dowolną zainstalowaną nazwę czcionki (np. 'Arial', 'Times New Roman') oraz FontSize w punktach. Zapewnia to hierarchię wizualną i czytelność na różnych urządzeniach i platformach.

: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

Jak wygląda niestandardowe stylizowanie czcionek?

Program WORD z czcionką Arial o rozmiarze 24 pkt wybraną na pasku narzędzi i wyświetlonym sformatowanym tekstem przykładowym

Jak pogrubić tekst?

Ustaw właściwość IsBold na true, aby uczynić tekst pogrubionym. Pogrubiony tekst jest powszechnie używany w nagłówkach, do podkreślania lub wyróżniania ważnych informacji. W połączeniu z innymi właściwościami stylistycznymi pogrubiony tekst tworzy hierarchię wizualną i poprawia czytelność.

: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

Jak wygląda pogrubiony tekst?

Interfejs programu Microsoft WORD pokazujący formatowanie pogrubionego tekstu z tekstem

Jak ustawić tekst kursywą?

Ustaw właściwość IsItalic na true, aby nadać styl kursywy. Tekst pisany kursywą jest zazwyczaj używany do podkreślenia, tytułów, słów obcych lub terminów technicznych. To subtelne formatowanie pozwala odróżnić elementy tekstu bez wizualnego obciążenia wynikającego z pogrubienia.

: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

Jak wygląda tekst pisany kursywą?

Dokument WORD zawierający tekst zapisany kursywą z widocznymi opcjami formatowania w zakładce

Jakie są dostępne właściwości stylizacji?

IronWord zapewnia kompleksowe właściwości stylistyczne odzwierciedlające opcje formatowania programu Microsoft WORD. Wszystkie te cechy składają się na złożone formatowanie tekstu spełniające profesjonalne standardy dokumentacji.

Metoda stylizacji Opis Przykład
TextFont Dostosowuje wygląd tekstu za pomocą obiektu Font, ustawiając rodzinę czcionek. Uwaga: FontSize jest ustawiane na poziomie TextStyle, a nie wewnątrz Font. textRun.Style = new TextStyle() { FontSize = 24, TextFont = new Font() { FontFamily = 'Calibri' } };
Color Ustawia kolor tekstu przy użyciu predefiniowanych kolorów z IronWord.Models.Color lub niestandardowych wartości szesnastkowych. textRun.Style.Color = IronWord.Models.Color.Red;
IsBold Ustawienie wartości true powoduje pogrubienie tekstu; często stosowane w nagłówkach lub w celu podkreślenia. textRun.Style.IsBold = true;
IsItalic Zastosowanie stylu kursywy do tekstu, gdy ustawiono wartość true; zazwyczaj używane do podkreślenia lub tytułów. textRun.Style.IsItalic = true;
Underline Dodaje podkreślenie do tekstu przy użyciu obiektu Underline z różnymi stylami podkreślenia. textRun.Style.Underline = new Underline();
Strike Zastosuj przekreślenie tekstu przy użyciu wyliczenia StrikeValue (Strike lub DoubleStrike). textRun.Style.Strike = StrikeValue.Strike;
Caps Zastosowano wielkie litery w tekście, zamieniając wszystkie znaki na wielkie. textRun.Style.Caps = true;
CharacterScale Dostosowuje proporcjonalną szerokość znaków jako procent ich normalnego rozmiaru. textRun.Style.CharacterScale = 150;
Emboss Nakłada efekt wytłoczenia na tekst, tworząc wrażenie wypukłości. textRun.Style.Emboss = true;
Emphasis Dodaje znaki podkreślenia do tekstu sformatowanego przy użyciu wartości wyliczeniowych EmphasisMarkValues. textRun.Style.Emphasis = EmphasisMarkValues.Dot;
LineSpacing Kontroluje odstępy między wierszami tekstu w celu poprawy czytelności za pomocą obiektu LineSpacing. textRun.Style.LineSpacing = new LineSpacing() { Value = 1.5 };
Outline Renderuje tekst z efektem konturu, wyświetlając tylko obramowania znaków. textRun.Style.Outline = true;
Shading Zastosowanie koloru tła lub cieniowania do tekstu przy użyciu obiektu Shading. textRun.Style.Shading = new Shading() { Color = Color.Yellow };
SmallCaps Zamienia małe litery na małe wielkie litery, zachowując rozróżnienie wielkości liter. textRun.Style.SmallCaps = true;
VerticalPosition Dostosowuje pionowe położenie tekstu względem jego linii bazowej, mierzone w punktach. textRun.Style.VerticalPosition = 5.0;
VerticalTextAlignment Wyrównuje tekst w pionie w obrębie kontenera przy użyciu wyliczenia VerticalPositionValues. textRun.Style.VerticalTextAlignment = VerticalPositionValues.Superscript;

Łączenie wielu stylów

Możliwości stylizacji tekstu w IronWord wynikają z łączenia wielu właściwości w celu uzyskania złożonego formatowania. Oto przykład pokazujący profesjonalnie sformatowany tekst dzięki połączeniu różnych właściwości stylizacji:

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

To kompleksowe podejście do stylizacji pozwala tworzyć dokumenty o spójnym wizerunku marki i profesjonalnym wyglądzie w całym procesie generowania dokumentów przez aplikację.

Często Zadawane Pytania

Jak programowo zastosować formatowanie tekstu w dokumentach Word w C#?

Klasa TextStyle w IronWord umożliwia zastosowanie profesjonalnego formatowania tekstu, w tym czcionek, kolorów, pogrubienia, kursywy i podkreślenia. Wystarczy utworzyć obiekt TextContent z tekstem, zastosować TextStyle z żądanymi właściwościami, dodać go do akapitu i zapisać dokument.

Jakie są podstawowe kroki do stylizacji tekstu w plikach DOCX?

Aby stylizować tekst za pomocą IronWord: 1) Zainstaluj IronWord przez NuGet, 2) Utwórz obiekt WordDocument, 3) Utwórz TextContent z tekstem, 4) Zastosuj właściwości TextStyle, takie jak czcionka, kolor lub pogrubienie, 5) Dodaj tekst do akapitu i zapisz.

Jakie opcje formatowania tekstu są dostępne?

Klasa TextStyle w IronWord zapewnia istotne opcje formatowania, w tym właściwości czcionki (FontFamily i FontSize), kolor tekstu, pogrubienie, kursywę, podkreślenie i przekreślenie. Opcje te można łączyć, aby stworzyć bogato sformatowany tekst.

Jak zmienić rodzinę i rozmiar czcionki tekstu?

Użyj właściwości TextFont w TextStyle, aby określić rodzinę i rozmiar czcionki. Ustaw FontFamily na czcionki takie jak 'Arial' lub 'Times New Roman', a FontSize na żądany rozmiar punktowy, na przykład 16 dla większego tekstu.

Czy mogę jednocześnie zastosować wiele stylów tekstu?

Tak, IronWord pozwala na łączenie wielu właściwości stylizacji w jednym obiekcie TextStyle. Możesz jednocześnie zastosować pogrubienie, kursywę, kolor i zmiany czcionki, aby stworzyć złożone formatowanie tekstu.

Jak zmienić kolor tekstu w dokumentach Word przy użyciu C#?

Właściwość Color w klasie TextStyle w IronWord pozwala na ustawienie koloru tekstu, używając zdefiniowanych kolorów z IronWord.Models.Color lub niestandardowych wartości HEX. Ta funkcja pomaga podkreślić konkretne treści lub dopasować kolory marki w dokumentach.

Ahmad Sohail
Ahmad Sohail
  Czat z zespołem inżynierów teraz
Full Stack Developer

Ahmad to full-stack developer z solidnym fundamentem w C#, Pythonie i technologiach webowych. Ma głębokie zainteresowanie tworzeniem skalowalnych rozwiązań oprogramowania i cieszy się badaniem, jak projektowanie i funkcjonalność spotykają się w rzeczywistych aplikacjach.

Przed dołączeniem do zespołu Iron Software, Ahmad pracował nad projektami ...

Czytaj więcej
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 38,043 | Wersja: 2026.4 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu? PM > Install-Package IronWord
uruchom próbkę zobacz, jak twoje dane stają się dokumentem Word.