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, stilize metinler için Run sarmalayıcı desenini göstermektedir.

  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şisi izler: Document → Paragraph → Run → TextContent. Bu hiyerarşiyi anlamak, şekillendirilmiş metinle çalışma konusunda önemlidir:

  • WordDocument: Belgenin tamamını temsil eden üst düzey kapsayıcı
  • Paragraph: Belge içindeki bir içerik bloğu
  • Run: TextContent öğesini içeren ve stil uygulanabilen bir sarmalayıcı nesne
  • TextContent: Asıl metin dizesi

Paragraflara İçerik Ekleme

IronWord, paragraflara içerik eklemenin iki yolu sunar:

  • AddText(TextContent): Stil uygulanmamış düz metin için kullanın. TextContent'yi doğrudan paragrafa ekler.
  • AddChild(Run): Biçimlendirilmiş metinler için kullanın. Paragrafa Run nesnesi (TextContent'yi sarar ve stil bilgilerini içerir) ekler.

Yazı tipi boyutu, renk veya kalın biçimlendirme gibi stil uygulamak istediğinizde, bir Run nesnesi oluşturun, TextStyle'ye Run atayın ve AddChild kullanarak bunu paragrafa ekleyin.

Metin Çalışmalarını Ekleyin

Metin İçeriği

Split yöntemi, metin dizisini belirli bir sınırlayıcıya göre daha küçük metin dizileri listesine 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 stilini ayarlamak için Run sarmalayıcı kalıbının kullanılması gerekir. TextContent içeren bir Run nesnesi oluşturun, ardından TextStyle'yi Run'ye (TextContent'ye değil) atayın. TextStyle, FontSize, renk, kalın, italik, üstü çizili, altı çizili, üst simge ve alt simge gibi görsel özellikleri tanımlamanıza olanak tanır.

FontSize'nin TextStyle düzeyinde yapılandırıldığını, FontFamily'nin ise TextFont özelliği içinde ayarlandığını unutmayın. Stil uygulandıktan sonra, AddChild kullanarak Run'yi bir paragrafa ekleyin. Bu, Document → Paragraph → Run → TextContent belge hiyerarşisini takip eder.

: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

IronWord, stil ayarlarının yanı sıra, stilin tutarlılığını korumak için mevcut belgelerden RGBA renk değerini almanızı sağlayan bir yol sunar.

: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.Paragraphs[0].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.Paragraphs(0).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, WordDocument kullanarak belgeyi yükleyin, ardından Paragraphs koleksiyonuna ve Texts dizisine erişerek TextContent nesnesini elde edin. Color özelliğinin TextContent değeri, metnin mevcut renginin RGBA değerini döndürür ve böylece belgenizin genelinde tutarlı bir stil kullanmanızı 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(new Paragraph(textRun));

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

' Load docx
Private doc As New WordDocument()

' Configure image
Private 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(New Paragraph(textRun))

' 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;
using IronSoftware.Abstractions.Word;

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

// Configure image
ImageContent image = new ImageContent("image.jpg");
image.TextWrapBehavior = new TextWrapSquare();
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
Imports IronSoftware.Abstractions.Word

' Load docx
Dim doc As New WordDocument()

' Configure image
Dim image As New ImageContent("image.jpg")
image.TextWrapBehavior = New TextWrapSquare()
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 44,829 | Sürüm: 2026.5 just released
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.