1. IronWord
  2. Nasıl Yapılır
  3. Metne Stil Ekle

How to Add Style to Text in DOCX with C

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

IronWord'un TextStyle sınıfı, .NET geliştiricilerinin yazı tipi, renkler, kalın, italik, altı çizili ve daha fazlasını içeren profesyonel metin biçimlendirmelerini programlı olarak Word belgelerine uygulamalarını sağlar. Rapor oluşturuyor, şablon yaratıyor ya da belge oluşturmayı otomatikleştiriyorsanız, IronWord, Microsoft Word'ün biçimlendirme seçeneklerini tekrarlayan kapsamlı stil araçları sunar.

Hızlı Başlangıç: C# ile DOCX'de Metne Stil Uygula

  1. NuGet Paket Yöneticisi ile https://www.nuget.org/packages/IronWord yükleyin

    PM > Install-Package IronWord

  2. Bu kod parçasını kopyalayıp çalıştırın.

    // 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. Canlı ortamınızda test etmek için dağıtın

    Bugün projenizde IronWord kullanmaya başlayın ücretsiz deneme ile

    arrow pointer

Minimal İş Akışı (5 adımda)

  1. IronWord C# kütüphanesini yükleyin
  2. TextContent içeren bir Run nesnesi oluşturun
  3. Run için FontSize, IsBold, Color gibi özellikler ile TextStyle uygulayın
  4. Stilli Run nesnesini AddChild kullanarak bir Paragraph içine ekleyin
  5. Uygulanan stillerle belgeyi kaydedin

DOCX'e Metin Stili Nasıl Eklerim?

IronWord'de metin stilleri uygulamak, Run saran modelini kullanmayı gerektirir. WordDocument nesnesi oluşturun, ardından metninizle TextContent içeren bir Run nesnesi oluşturun. TextStyle, Run (TextContent değil) üzerine IsBold, Color veya FontSize gibi özellikler kullanarak uygulayın.

Stil uygulandıktan sonra Run nesnesini Paragraph nesnesine AddChild kullanarak ekleyin, paragrafı belgeye yerleştirin ve sonucu kaydedin. Bu yaklaşım, tutarlı stil gerektiren otomatik belge oluşturma senaryoları için metin biçimlendirmesi üzerinde programatik kontrol sağlar.

Lütfen dikkate alinIronWord'un belge hiyerarşisi şu yapıyı takip eder: Belge → BelgeBölümü → Paragraf → Akış → Metinİçeriği. Stiller Akış düzeyinde uygulanır, doğrudan Metinİçeriği üzerinde değil.

: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

Bu Ne Tür Çıktı Üretecek?

Microsoft Word arayüzü şerit düzeni gösterilmekte ve uygulanmış kırmızı üstü çizili metin biçimlendirmesiyle belge

TextStyle sınıfı, yazı tipi özellikleri, metin rengi, kalın, italik ve altını çizme dahil olmak üzere temel biçimlendirme seçenekleri sunar. Not: FontSize TextStyle düzeyinde yapılandırılır (Font içinde değil), FontFamily ise TextFont özelliği içinde ayarlanır. Run nesnesi TextContent sarar ve IronWord'un belge hiyerarşi modeline uygun olarak stili barındırır. Örnek, bir Run üzerine uygulandığında zengin biçimlendirilmiş metin oluşturmak için birden fazla stil özelliklerinin nasıl bir araya geldiğini gösterir.

Hangi Özel Stilleri Ekleyebilirim?

Metin Rengini Nasıl Değiştiririm?

Color özelliği, TextStyle içindeki metin rengini IronWord.Models.Color'den önceden tanımlanmış renkler veya özel hex değerleri kullanarak ayarlar. Bu, belirli içeriği vurgular veya marka renklerini eşleştirir. IronWord, Kırmızı, Mavi, Yeşil, Zeytin, Lacivert ve Bordo dahil olmak üzere geniş bir renk yelpazesini destekler.

: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

Renkli Metin Ne Görünür?

Microsoft Word, ana sekme şeridi ile yazı tipi ve paragraf araçlarını gösteren zeytin rengi metin biçimlendirmesi

Yazı Tipi Ailesini ve Boyutunu Nasıl Ayarlarım?

TextFont özelliği ile metin görünümünü özelleştirin. FontFamily'yi yüklenmiş herhangi bir yazı tipi adına (örneğin, "Arial", "Times New Roman") ve FontSize'yi puan olarak ayarlayın. Bu, görsel hiyerarşi kurar ve farklı cihazlar ve platformlar arasında okunabilirliği sağlar.

: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

Özel Yazı Tipi Stili Ne Görünür?

Microsoft Word, araç çubuğunda seçili 24pt Arial yazı tipini gösteriyor ve biçimlendirilmiş örnek metni gösteriyor

Metni Nasıl Kalın Yapabilirim?

IsBold özelliğini true olarak ayarlayarak metni kalın yapın. Kalın metin genellikle başlıklar, vurgu veya önemli bilgilerin vurgulanması için kullanılır. Diğer stil özellikleri ile kombine edildiğinde, kalın metin görsel hiyerarşi yaratır ve okunabilirliği artırır.

: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

Kalın Metin Ne Görünür?

Microsoft Word arayüzü,

Metni Nasıl İtalik Yapabilirim?

IsItalic özelliğini true olarak ayarlayarak italik stili uygulayın. İtalik metin genellikle vurgu, başlıklar, yabancı kelimeler veya teknik terimler için kullanılır. Bu ince biçimlendirme, kalın biçimlendirmenin görsel ağırlığı olmadan metin unsurlarını farklılaştırır.

: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

İtalik Metin Ne Görünür?

Ana sekme biçimlendirme seçeneklerinin entegrasyonu ile Word belgesi, italikleştirilmiş metin gösteriyor

Mevcut Stil Özellikleri Nelerdir?

IronWord, Microsoft Word'ün biçimlendirme seçeneklerini yansıtan kapsamlı stil özellikleri sunar. Bu özellikler, profesyonel belge standartlarını karşılayan karmaşık metin biçimlendirmeleri yaratmak için birleşir.

Biçimlendirme Yöntemi Açıklama Örnek
TextFont Bir Font nesnesi ile metin görünümünü özelleştirir, yazı tipi ailesini ayarlar. Not: FontSize TextStyle düzeyinde ayarlanır, Font içinde değil. textRun.Style = new TextStyle() { FontSize = 24, TextFont = new Font() { FontFamily = "Calibri" } };
Color IronWord.Models.Color veya özel hex değerlerinden önceden tanımlanmış renkler kullanarak metin rengini ayarlar. textRun.Style.Color = IronWord.Models.Color.Red;
IsBold true olarak ayarlandığında, metni kalın yapar, genellikle başlıklar veya vurgu için kullanılır. textRun.Style.IsBold = true;
IsItalic true olarak ayarlandığında metne italik bir stil uygular, genellikle vurgu veya başlıklar için kullanılır. textRun.Style.IsItalic = true;
Underline Çeşitli alt çizgi stilleriyle metne bir Underline nesnesi kullanarak alt çizgi ekler. textRun.Style.Underline = new Underline();
Strike StrikeValue enum (Strike veya DoubleStrike) kullanılarak metne üstü çizili uygulanır. textRun.Style.Strike = StrikeValue.Strike;
Caps Metne kapitalizasyon efektleri uygular, tüm karakterleri büyük harfe dönüştürür. textRun.Style.Caps = true;
CharacterScale Karakterlerin normal boyutlarının yüzdesi olarak orantılı genişliğini ayarlar. textRun.Style.CharacterScale = 150;
Emboss Metne kabartma bir efekt uygular, yükseltilmiş bir görünüm oluşturur. textRun.Style.Emboss = true;
Emphasis EmphasisMarkValues enum değerleri kullanarak stili uygulanmış metne vurgu işaretleri ekler. textRun.Style.Emphasis = EmphasisMarkValues.Dot;
LineSpacing Okunabilirliği artırmak için satır aralığını kontrol eder, bir LineSpacing nesnesi kullanır. textRun.Style.LineSpacing = new LineSpacing() { Value = 1.5 };
Outline Karakter sınırlarını göstermek üzere metni bir çizgi efekti ile render eder. textRun.Style.Outline = true;
Shading Bir Shading nesnesi kullanarak metne arka plan rengi veya gölgeleme uygular. textRun.Style.Shading = new Shading() { Color = Color.Yellow };
SmallCaps Alt harfleri küçük baş harflerle değiştirirken büyük/küçük harf ayrımını korur. textRun.Style.SmallCaps = true;
VerticalPosition Metnin temel çizgisine göre metnin dikey konumunu ayarlar, puan cinsinden ölçülür. textRun.Style.VerticalPosition = 5.0;
VerticalTextAlignment Metni VerticalPositionValues enum kullanarak kapsayıcısı içerisinde dikey olarak konumlandırır. textRun.Style.VerticalTextAlignment = VerticalPositionValues.Superscript;

Çoklu Stilleri Birleştirme

IronWord'un metin stil gücü, karmaşık biçimlendirme elde etmek için birden fazla özelliği birleştirmekten gelir. İşte çeşitli stil özelliklerini birleştirerek profesyonelce stilize edilmiş metni gösteren bir örnek:

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

Bu kapsamlı stil yaklaşımı, belgeleri tutarlı markalama ve uygulamanızın belge oluşturma süreci boyunca profesyonel görünümü sürdürerek oluşturur.

Sıkça Sorulan Sorular

Word belgelerine programlı olarak metin formatlaması C# ile nasıl uygulayabilirim?

IronWord'un TextStyle sınıfı, yazı tipleri, renkler, kalın, italik ve altı çizili dahil profesyonel metin formatlaması uygulamanıza olanak tanır. Metninizle bir TextContent nesnesi oluşturun, arzu edilen özelliklerle bir TextStyle uygulayın, bir paragrafa ekleyin ve belgeyi kaydedin.

DOCX dosyalarında metni stilize etmenin temel adımları nelerdir?

IronWord ile metni stilize etmek için: 1) IronWord'u NuGet ile yükleyin, 2) Bir WordDocument nesnesi oluşturun, 3) Metninizle TextContent oluşturun, 4) Yazı tipi, renk veya kalın gibi TextStyle özelliklerini uygulayın, 5) Metni bir paragrafa ekleyin ve kaydedin.

Hangi metin formatlama seçenekleri mevcut?

IronWord'un TextStyle sınıfı, yazı tipi özellikleri (FontFamily ve FontSize), metin rengi, kalın, italik, altı çizili ve üzeri çizili dahil olmak üzere temel formatlama seçenekleri sağlar. Bu seçenekler zengin formatlı metinler oluşturmak için birleştirilebilir.

Metin yazı tipi ailesini ve boyutunu nasıl değiştiririm?

TextStyle içindeki TextFont özelliğini kullanarak yazı tipi ailesini ve boyutunu belirtin. FontFamily özelliğini 'Arial' veya 'Times New Roman' gibi yazı tiplerine, FontSize özelliğini ise 16 gibi daha büyük metin boyutlarına ayarlayın.

Aynı anda birden fazla metin stili uygulayabilir miyim?

Evet, IronWord tek bir TextStyle nesnesinde birden fazla stil özelliğini birleştirmenize olanak tanır. Kalın, italik, renk ve yazı tipi değişikliklerini bir arada uygulayarak karmaşık metin formatlaması oluşturabilirsiniz.

Word belgelerinde metin rengini C# kullanarak nasıl değiştiririm?

IronWord'un TextStyle sınıfındaki Color özelliği, metin rengini IronWord.Models.Color'dan önceden tanımlanmış renkler veya özel hex değerleri kullanarak ayarlamanıza olanak tanır. Bu özellik, belgelerinizde belirli içerikleri vurgulamaya veya marka renklerini eşleştirmeye yardımcı olur.

Ahmad Sohail
Ahmad Sohail
  Mühendislik takımıyla şimdi sohbet edin
Full Stack Geliştirici

Ahmad, C#, Python ve web teknolojilerinde güçlü bir temele sahip bir full-stack geliştiricidir. Ölçeklenebilir yazılım çözümleri oluşturma konusunda derin bir ilgiye sahiptir ve tasarım ile işlevselliğin gerçek dünya uygulamalarında nasıl birleştiğini keşfetmekten ...

Daha Fazlasını Oku
Başlamaya Hazır mısınız?
Nuget İndirmeler 39,467 | Sürüm: 2026.4 just released
Still Scrolling Icon

Hala Kaydiriyor musunuz?

Hızlı bir kanit mi istiyorsunuz? PM > Install-Package IronWord
bir örnek çalıştır verilerinizin bir Word belgesine dönüştüğünü izleyin.