C# Document Element Tutorial
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.
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.
-
1Install IronWord with NuGet Package Manager
-
2Bu 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");C# -
3Canlı ortamınızda test için dağıtım yapın
Ücretsiz deneme ile bugün projenizde IronWord kullanmaya başlayın
İçindekiler
- Metin Ekle
- Metin İçeriği (Ekle, Ekleyin & Böl)
- Stili Ayarlayın (Yazı Tipi Ailesi & Boyutu, Renk, Kalın & İtalik, Üzeri Çizili, Altı Çizili, Üst Simge & Alt Simge)
- Resimleri Göm
- Resim Ekle
- Resmi Yükle (Dosya & FileStream)
- Metni Sarma Ayarla
- Boyutları Ayarla (Genişlik & Yükseklik)
- Konum Ofsetini Ayarla
- Köşelerden Uzaklığı Ayarla
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 konteynerParagraph: Belge içinde bir içerik bloğuRun:TextContentiçeren ve stil uygulanabilecek bir sarmalayıcı nesneTextContent: 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ğrudanTextContentekler.AddChild(Run): Stil verilmiş metin için kullanılır.TextContentve stil bilgisini sararak paragrafa eklenebilen birRunnesnesi 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.
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")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.
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")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.
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);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.
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");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.
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")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.
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");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.
How do you save a Word document created with IronWord?
A Word document created with IronWord can be saved using the 'SaveAs' method, specifying the filename and path for saving the document.
What is the function of the 'AddParagraph' method in IronWord?
The 'AddParagraph' method in IronWord is used to add fully configured paragraphs, with text and images, to a Word document.
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ılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.
