1. IronWord
  2. Eğitimler
  3. Belge Elemanı
C#'da Belge Elemanlari Ile Nasil Calisilir

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, uygulamalarina Word ve DOCX dokümanlarini oluşturma, okuma ve duzenleme yeteneklerini entegre etmelerinde yardimci olmak icin tasarlanmis guclu bir Word doküman kutuphanesidir. Bir Word dokümaninin baglaminda, doküman elemanlari icerigi oluşturan yapi taslaridir.

Hizli Başlangic: Stilli Bir TextRun Oluşturun ve Bir Resim Gommenin

IronWord'u kullanarak bir dokümanda stilli metin ve gomulu bir resmi birlestirerek zengin içerik nasıl ekleyebileceginizi burada bulabilirsiniz. Bu örnek, stilli metin icin Run sarmal kalibini göstermektedir.

  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.

    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 etmek için dağıtın

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

    arrow pointer

İçindekiler

Anahtar Kavramlar

Doküman Hiyerarsisi

IronWord, yapılandırilmis bir doküman hiyerarsisini takip eder: Doküman → Paragraf → Run → TextContent. Bu hiyerarsiyi anlamak, stilli metinle calismak icin onemlidir:

  • WordDocument: Tüm dokümani temsil eden en ust seviye kapsayici
  • Paragraph: Doküman icindeki bir içerik blogu
  • Run: TextContent u iceren ve stil uygulayabilen bir sarmal nesne
  • TextContent: Gerçek metin dizesi

Paragraflara İçerik Ekleme

IronWord, paragraflara içerik eklemek icin iki yöntem sunar:

  • AddText(TextContent): Stil uygulanmamis duz metin icin kullanin. TextContent'yi dogrudan paragrafa ekler.
  • AddChild(Run): Stilli metin icin kullanin. Paragrafa Run nesnesi (TextContent'u saran ve stili tutan) ekler.

Yazı tipi boyutu, renk veya kalın biçimlendirme gibi stiller uygulamanız gerektiginde, bir Run nesnesi oluşturun, bir TextStyle'yi Run'ya atayin ve AddChild'yu paragrafa eklemek icin kullanin.

TextRuns Ekleyin

Metin İçeriği

Split metodu, metin bölümunu belirli bir ayirac bazında daha küçük metin bölümleri listesine ayirir. Bu, doküman icindeki metinsel bilgilerin duzenlenmesine ve yonetilmesine olanak tanir.

: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 icin stil ayarlamak, Run sarmallama desenini kullanmayı gerektirir. Run (içinde TextContent barindiran) bir nesne oluşturun, ardından TextStyle, Run'ye (değil TextContent) atayin. TextStyle, FontSize gibi görsel öznitelikleri, renk, kalın, italik, üstü çizgili, altı çizili, üstsabit ve altsabit tanımlamanıza olanak tanır.

Unutmayın ki FontSize, TextStyle seviyesinde yapılandırılırken, FontFamily, TextFont özelliği icinde ayarlanır. Bir kez stil verdikten sonra AddChild ile bir Run'yi paragrafa ekleyin. Bu, doküman hiyerrarşisini takip eder: Doküman → Paragraf → Kosu → 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 Dolgu Rengini Al

Stil ayalamaniin dışında, IronWord, mevcut dokümanlardan RGBA renk değerini almanıza olanak tanır, bu da stil boyunca tutarlılık saglamanizi saglar.

: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 degerlerini almak icin, WordDocument kullanarak dokümani yukleyin, ardından Paragraphs koleksiyonuna ve Texts dizinize erişerek TextContent nesnesini ele geçirin. TextContent'nun Color özelliği, metnin mevcut renginin RGBA değerini döndürür ve bu da dokümanınız boyunca stil tutarlılığı sağlar.

Resim Göm

Bu özellik, içeriğe görüntüleri sorunsuz şekilde dahil etmenize olanak tanır, bu da dokümanın genel görsel çekiciliğini ve iletişim 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

Resimler Ekle

Resim Yükle

Resimleri yüklemek önemli bir süreçtir. Bu, harici resim dosyalarının dokümana getirilmesini içerir. Resim yükleme yeteneği, ilgili görsellerin dahil edilmesini kolaylaştırarak, daha çekici ve bilgilendirici bir doküman oluşmasına katkı 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

Resmi Yapılandır

Yapılandırılabilir ayarlarla resimleri optimize edin. Bu, metni sarma, boyutlandırma, pozisyon ve köşelerden mesafe gibi özellikleri ayarlamayı içerir. Dogru yapılandırma, görüntülerin görsel açıdan hoş ve bağlamsal olarak uygun şekilde gösterilmesini 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?

Bir Word belgesine metin ekleyebilir, ardından bu metni bir paragraf içerisinde eklemek için IronWord'u kullanarak bir metin çalıştırma örneği oluşturabilirsiniz.

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

IronWord, kolay metin manipülasyonunu sağlamak için belirli bir ayıraç temelinde bir metin çalıştırmasını daha küçük segmentlere bölmenizi sağlayan Split metodunu sağlar.

IronWord kullanarak bir Word belgesinde metni nasıl stilize edebilirim?

IronWord kullanarak metni, yazı tipi boyutu, renk ve kalın, italik, üstü çizili, altı çizili, üst simge ve alt simge gibi stiller gibi çeşitli öznitelikler ayarlayarak stilize edebilirsiniz.

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

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

Bir Word belgesine resim yükleme adımları nelerdir?

IronWord ile, bir dosyadan veya bir dosya akışından bir resim yükleyebilir, bu sayede bir Word belgesine görsel içerik ekleyebilirsiniz.

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

IronWord kullanarak resim özelliklerini, metin kaydırma, boyutlar, konum kayması ve köşelerden uzaklık gibi belgede doğru resim görüntülemesine yönelik özelliklerini yapılandırabilirsiniz.

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

Evet, IronWord mevcut bir belgedeki metnin RGBA renk değerini tutarlı stil sağlamak için almanızı sağlar.

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

IronWord ile başlamanız için, Word belgelerini oluşturma, okuma ve düzenlemek için kapsamlı kitaplık özelliklerinden yararlanarak .NET C# uygulamanıza entegre edebilirsiniz.

Curtis Chau
Curtis Chau
  Mühendislik takımıyla şimdi sohbet edin
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında lisans derecesine sahiptir (Carleton Üniversitesi) ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirme üzerine uzmanlaşmıştır. Kullanıcı dostu ve estetik açıdan hoş arayüzler tasarlamaya tutkuyla bağlı olan Curtis, modern çerç...

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.