1. IronWord
  2. Öğreticiler
  3. Belge Elemanı
C#'ta Belge Öğeleri Nasıl Çalışılır

C# Document Element Tutorial

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

IronWord, .NET C# geliştiricilerine uygulamalarına Word ve DOCX belgeleri oluşturma, okuma ve düzenleme yeteneklerini entegre etme konusunda yardımcı olmak için tasarlanmış güçlü bir Word belge kütüphanesidir. Bir Word belgesi bağlamında, belge öğeleri içeriği oluşturan yapı taşlarıdır.

as-heading:2(Hızlı Başlangıç: Şekillendirilmiş Bir Metin Çalıştırma (TextRun) ve Bir Resim Gömme)

İşte bir belgede zengin içerik eklemek için IronWord kullanarak şekillendirilmiş metin ve gömülü bir resmi birleştirme yönteminiz. Bu örnek, stillendirilmiş metin için Run sarmalayıcı modelini gösterir.

  1. IronWord aşağıdaki NuGet Paket Yöneticisi ile yükleyin

    PM > Install-Package IronWord

  2. Bu kod parçacığını kopyalayın ve çalıştırın.

    using IronWord;
using IronWord.Models;

// Create document
WordDocument doc = new WordDocument();

// Create styled Run
Run textRun = new Run(new TextContent("Hello IronWord!"));
textRun.Style = new TextStyle() { IsBold = true, Color = Color.Blue };

// Create paragraph and add Run
Paragraph paragraph = new Paragraph();
paragraph.AddChild(textRun);
paragraph.AddImage(new ImageContent("pic.png"));

// Add to document and save
doc.AddParagraph(paragraph);
doc.SaveAs("output.docx");

  3. Canlı ortamınızda test için dağıtım yapın

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

    arrow pointer

İçindekiler

Anahtar Kavramlar

Belge Hiyerarşisi

IronWord, yapılandırılmış bir belge hiyerarşisini takip eder: Document → Paragraph → Run → TextContent. Bu hiyerarşiyi anlamak, şekillendirilmiş metinle çalışma konusunda önemlidir:

  • WordDocument: Tüm belgeyi temsil eden en üst düzey konteyner
  • Paragraph: Belge içinde bir içerik bloğu
  • Run: TextContent içeren ve stil uygulanabilecek bir sarmalayıcı nesne
  • TextContent: Gerçek metin dizgisi

Paragraflara İçerik Ekleme

IronWord, paragraflara içerik eklemenin iki yolu sunar:

  • AddText(TextContent): Biçimlendirilmemiş düz metin için kullanılır. Paragrafa doğrudan TextContent ekler.
  • AddChild(Run): Stil verilmiş metin için kullanılır. TextContent ve stil bilgisini sararak paragrafa eklenebilen bir Run nesnesi ekler.

Yazı boyutu, renk veya kalın yazı biçimlendirmesi gibi stil eklemeniz gerektiğinde, bir Run nesnesi oluşturun, TextStyle'yi Run'ye atayın ve paragrafa eklemek için AddChild'yi kullanın.

Metin Çalışmalarını Ekleyin

Metin İçeriği

Split yöntemi, belirli bir ayırıcıya göre metin akışını daha küçük metin akışlarından oluşan bir listeye bölmek için kullanılır. Bu, belgede metin bilgilerini organize etme ve üzerinde işlem yapma olanağı sağlar.

:path=/static-assets/word/content-code-examples/tutorials/add-textrun-text-content.cs
using IronWord;
using IronWord.Models;

WordDocument doc = new WordDocument();

// Add text
TextContent addText = new TextContent("Add text using IronWord");
doc.AddParagraph(new Paragraph(addText));

// Append text
TextContent appendText = new TextContent("The first text.");
appendText.Append(new TextContent("The second text."));
doc.AddParagraph(new Paragraph(appendText));

// Split text
TextContent splitText = new TextContent("Use split to split the sentence.");
splitText.Split(" ");
doc.AddParagraph(new Paragraph(splitText));

// Export docx
doc.SaveAs("textrun.docx");
Imports IronWord
Imports IronWord.Models

Private doc As New WordDocument()

' Add text
Private addText As New TextContent("Add text using IronWord")
doc.AddParagraph(New Paragraph(addText))

' Append text
Dim appendText As New TextContent("The first text.")
appendText.Append(New TextContent("The second text."))
doc.AddParagraph(New Paragraph(appendText))

' Split text
Dim splitText As New TextContent("Use split to split the sentence.")
splitText.Split(" ")
doc.AddParagraph(New Paragraph(splitText))

' Export docx
doc.SaveAs("textrun.docx")
$vbLabelText   $csharpLabel

Stil Ayarla

Metin için stil belirlemek, Run sarmalayıcı modelinin kullanılmasını gerektirir. Run nesnesi oluşturun, TextContent içeren, ardından TextStyle'yi Run'ye atayın (TextContent değil). TextStyle, FontSize, renk, kalın, italik, üstü çizili, altı çizili, üstsimge ve altsimge gibi görsel özellikleri tanımlamanıza olanak tanır.

FontSize, TextStyle seviyesinde yapılandırılmışken, FontFamily TextFont özelliği içinde ayarlanır. Stil verildikten sonra, AddChild kullanarak paragrafa Run ekleyin. Bu, belge hiyerarşisini takip eder: Document → Paragraph → Run → TextContent.

:path=/static-assets/word/content-code-examples/tutorials/add-textrun-set-styling.cs
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// Load docx
WordDocument doc = new WordDocument("document.docx");

// Configure text
Run textRun = new Run(new TextContent("Add text using IronWord"));
textRun.Style = new TextStyle()
{
    FontSize = 72,
    TextFont = new Font()
    {
        FontFamily = "Caveat"
    },
    Color = Color.Red,
    IsBold = true,
    IsItalic = true,
    Underline = new Underline(),
    Strike = StrikeValue.Strike,
};

Paragraph paragraph = new Paragraph();

// Add text
paragraph.AddChild(textRun);

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("save_document.docx");
Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

' Load docx
Dim doc As New WordDocument("document.docx")

' Configure text
Dim textRun As New Run(New TextContent("Add text using IronWord"))
textRun.Style = New TextStyle() With {
    .FontSize = 72,
    .TextFont = New Font() With {
        .FontFamily = "Caveat"
    },
    .Color = Color.Red,
    .IsBold = True,
    .IsItalic = True,
    .Underline = New Underline(),
    .Strike = StrikeValue.Strike
}

Dim paragraph As New Paragraph()

' Add text
paragraph.AddChild(textRun)

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("save_document.docx")
$vbLabelText   $csharpLabel

Metin Doldurma Rengini Edinme

Stil belirlemenin yanı sıra, IronWord mevcut belgelerden RGBA renk değerini elde etmenize olanak tanır, böylece stil boyunca tutarlılığı koruyabilirsiniz.

:path=/static-assets/word/content-code-examples/tutorials/rgba-color-value.cs
using IronWord;
using IronWord.Models;
using System;

// Open existing Word
WordDocument doc = new WordDocument("Accent1TextThemcolor.docx");

TextContent content = doc.Texts[0];

// This will show the R G B A of the themecolor
var filledColor = content.Color;

// Print the filled color variable to the console
Console.WriteLine(filledColor);
Imports IronWord
Imports IronWord.Models
Imports System

' Open existing Word
Dim doc As New WordDocument("Accent1TextThemcolor.docx")

Dim content As TextContent = doc.Texts(0)

' This will show the R G B A of the themecolor
Dim filledColor = content.Color

' Print the filled color variable to the console
Console.WriteLine(filledColor)
$vbLabelText   $csharpLabel

Renk değerlerini almak için, belgeleri WordDocument kullanarak yükleyin, ardından Paragraphs koleksiyonuna ve Texts dizisine erişerek TextContent nesnesini elde edin. TextContent'nin Color özelliği, metnin mevcut renginin RGBA değerini döndürerek, belgenizde tutarlı stilin korunmasını sağlar.

Görselleri Gömme

Bu özellik, içeriğe sorunsuz bir şekilde görseller eklemenizi sağlar, bu da belgenin genel görsel çekiciliğini ve ifade gücünü artırır.

:path=/static-assets/word/content-code-examples/tutorials/add-textrun-embed-images.cs
using IronWord;
using IronWord.Models;

// Load docx
WordDocument doc = new WordDocument();

// Configure image
ImageContent image = new ImageContent("image.jpg");
image.Width = 200; // In unit pixel
image.Height = 200; // In unit pixel
TextContent textRun = new TextContent();

// Add image
Paragraph para = new Paragraph(textRun);
para.AddImage(image);

// Add paragraph
doc.AddParagraph(para);

// Export docx
doc.SaveAs("save_document.docx");
Imports IronWord
Imports IronWord.Models

' Load docx
Dim doc As New WordDocument()

' Configure image
Dim image As New ImageContent("image.jpg")
image.Width = 200 ' In unit pixel
image.Height = 200 ' In unit pixel
Dim textRun As New TextContent()

' Add image
Dim para As New Paragraph(textRun)
para.AddImage(image)

' Add paragraph
doc.AddParagraph(para)

' Export docx
doc.SaveAs("save_document.docx")
$vbLabelText   $csharpLabel

Resim Ekle

Görsel Yükleme

Görselleri yüklemek kritik bir süreçtir. Bu, harici görüntü dosyalarını belgeye getirmeyi içerir. Görsellerin yüklenebilmesi, ilgili görsellerin dahil edilmesini kolaylaştırarak daha ilgi çekici ve bilgilendirici bir belge sağlar.

:path=/static-assets/word/content-code-examples/tutorials/add-image-load-image.cs
using IronWord;
using IronWord.Models;

// Load docx
WordDocument doc = new WordDocument();

Paragraph paragraph = new Paragraph();

// Add image
paragraph.AddImage("image.jpg");

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("document.docx");
Imports IronWord
Imports IronWord.Models

' Load docx
Private doc As New WordDocument()

Private paragraph As New Paragraph()

' Add image
paragraph.AddImage("image.jpg")

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("document.docx")
$vbLabelText   $csharpLabel

Görseli Yapılandırma

Ayarlanabilir ayarlarla görselleri optimize edin. Bu, metin sarmalama, boyutlar, konum ve köşelerden uzaklık gibi özelliklerin ayarlanmasını içerir. Uygun yapılandırma, görsellerin görsel olarak hoş ve bağlamsal olarak uygun şekilde görüntülenmesini sağlar.

:path=/static-assets/word/content-code-examples/tutorials/add-image-configure-image.cs
using IronWord;
using IronWord.Models;
using IronWord.Models.Enums;

// Load docx
WordDocument doc = new WordDocument();

// Configure image
ImageContent image = new ImageContent("image.jpg");
image.Width = 100;
image.Height = 100;
image.DistanceFromTop = 50;

var position = new ElementPosition();
position.X = 50;
position.Y = 50;
image.Position = position;

Paragraph paragraph = new Paragraph();

// Add image
paragraph.AddImage(image);

// Add paragraph
doc.AddParagraph(paragraph);

// Export docx
doc.SaveAs("document.docx");
Imports IronWord
Imports IronWord.Models
Imports IronWord.Models.Enums

' Load docx
Dim doc As New WordDocument()

' Configure image
Dim image As New ImageContent("image.jpg")
image.Width = 100
image.Height = 100
image.DistanceFromTop = 50

Dim position As New ElementPosition()
position.X = 50
position.Y = 50
image.Position = position

Dim paragraph As New Paragraph()

' Add image
paragraph.AddImage(image)

' Add paragraph
doc.AddParagraph(paragraph)

' Export docx
doc.SaveAs("document.docx")
$vbLabelText   $csharpLabel

Sıkça Sorulan Sorular

C# kullanarak bir Word belgesine nasıl metin ekleyebilirim?

IronWord kullanarak, bir belgede bir paragrafa eklenebilecek bir metin çalıştırma örneği oluşturarak Word belgesine metin ekleyebilirsiniz.

Bir Word belgesinde metni bölme yöntemi nedir?

IronWord, bir metin çalıştırmasını belirtilen bir ayraç temelinde daha küçük segmentlere ayırmanıza olanak tanıyan Split yöntemini sağlar, böylece metin manipulasyonu kolaylaşır.

IronWord kullanarak bir Word belgesinde metni nasıl şekillendiririm?

IronWord kullanarak, yazı boyutu, renk ve kalın, italik, üstü çizili, altı çizili, üstsimge ve altsimge gibi stil gibi çeşitli öznitelikleri ayarlayarak metni şekillendirebilirsiniz.

C# ile bir Word belgesine resimleri nasıl gömebilirim?

IronWord kullanarak bir Word belgesine resimleri gömmek için bir dosyadan bir resmi yükleyebilir ve belge içinde bir paragrafa satır içi resim olarak ekleyebilirsiniz.

Bir Word belgesine bir resim yüklemede hangi adımlar yer alır?

IronWord ile, bir dosya veya dosya akışından resim yükleyebilirsiniz, bu da bir Word belgesine görsel içerik eklemenize olanak tanır.

Bir Word belgesinde resim özelliklerini nasıl yapılandırırım?

IronWord kullanarak, metin sarmalama, boyutlar, konum offseti ve köşelerden mesafe gibi resim özelliklerini yapılandırabilirsiniz ve bununla doğru resim görüntüsü elde edersiniz.

Bir Word belgesinde metnin RGBA renk değerini alabilir miyim?

Evet, IronWord mevcut belgedeki metnin RGBA renk değerini almanıza olanak tanır, böylece tutarlı bir şekillendirme sağlayabilirsiniz.

Word belge manipulasyonu için IronWord'u nasıl kullanmaya başlayabilirim?

IronWord ile başlamak için, .NET C# uygulamanıza entegre ederek, Word belgelerini oluşturabilir, okuyabilir ve düzenleyebilir, kapsamlı kütüphane özelliklerini kullanabilirsiniz.

Iron Software, IronWord için ne tür bir destek sunuyor?

Iron Software, IronWord için belgeler, eğitimler ve müşteri desteği dahil olmak üzere kapsamlı bir destek sağlar, geliştiricilerin uygulamada yardımcı olur.

IronWord için ücretsiz bir deneme mevcut mu?

Evet, Iron Software, geliştiricilerin özelliklerini ve yeteneklerini incelemelerine olanak tanıyan IronWord için ücretsiz bir deneme sunar, satın alma kararı öncesi.

Curtis Chau
Curtis Chau
  Mühendislik ekibiyle şimdi sohbet edin
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapı...

Daha Fazla Oku
Başlamaya Hazır mısınız?
Nuget İndirmeler 49,323 | Sürüm: 2026.7 yeni yayınlandı
Still Scrolling Icon

Hâlâ Kaydırıyor Musunuz?

Hızlıca kanıt ister misiniz? PM > Install-Package IronWord
bir örnek çalıştırın verilerinizi bir Word belgesine dönüştürün.