C#'da Biçimlendirmeli Word Belgesi Nasil Okunur

How to Create Word Documents Without Office Interop in C

1. Yeni bir C# projesi oluşturun.
2. IronWord kütüphanesini yükleyin.
3. IronWord kütüphanesini kullanarak bir Word belgesi oluşturun.
4. Artık var olan belgeye içerik ekleyin.
5. Oluşturulan Word belgesini kaydedin.
6. Oluşturulan Word belgesini açın ve gösterin.

Ön koşullar:

1. Visual Studio: Visual Studio veya başka bir C# geliştirme ortamı yüklendiğinden emin olun.
2. NuGet Paket Yöneticisi: Projenizde paketleri yönetmek için NuGet kullanabileceğinizden emin olun.

Adım 1: Yeni C# Projesini Oluştur

Kelimenizi oluşturmak istediğiniz yeni bir C# konsol uygulaması oluşturun veya mevcut bir projeyi kullanın.

Konsol uygulama şablonunu seçin ve devam etmek için tıklayın.

Bir sonraki adımda, çözüm ve proje adlarını belirtebilirsiniz.

.NET Sürümünü seçin ve "Oluştur"a tıklayın.

Adım 2: IronWord Kütüphanesini Yükleyin

C# projenizi açın ve NuGet Paket Yöneticisi Konsolunu kullanarak IronWord kütüphanesini yükleyin:

Install-Package IronWord -Version 2024.1.2

NuGet paketi, aşağıda gösterildiği gibi, Visual Studio Paket Yöneticisi kullanılarak da yüklenebilir.

Adım 3: IronWord Kütüphanesini Kullanarak bir Word Belgesi Oluşturun ve Kaydedin

IronWord kütüphanesini kullanarak bir Word belgesi oluşturmaya dair basit bir örnekle başlayalım. Aşağıdaki kod, "Hello, World!" metnini içeren bir paragrafla temel bir Word belgesinin nasıl oluşturulacağını gösterir.

using IronWord;
using IronWord.Models;

// Create a text run instance with "Hello, World!" content
TextRun textRun = new TextRun("Hello, World!");

// Create a paragraph and add the text run to it
Paragraph paragraph = new Paragraph();
paragraph.AddTextRun(textRun);

// Create a new Word document object with the paragraph
WordDocument doc = new WordDocument(paragraph);

// Save the document as a .docx file
doc.SaveAs("example.docx"); // Saves the file to disk with the name example.docx

using IronWord;
using IronWord.Models;

// Create a text run instance with "Hello, World!" content
TextRun textRun = new TextRun("Hello, World!");

// Create a paragraph and add the text run to it
Paragraph paragraph = new Paragraph();
paragraph.AddTextRun(textRun);

// Create a new Word document object with the paragraph
WordDocument doc = new WordDocument(paragraph);

// Save the document as a .docx file
doc.SaveAs("example.docx"); // Saves the file to disk with the name example.docx

Imports IronWord
Imports IronWord.Models

' Create a text run instance with "Hello, World!" content
Private textRun As New TextRun("Hello, World!")

' Create a paragraph and add the text run to it
Private paragraph As New Paragraph()
paragraph.AddTextRun(textRun)

' Create a new Word document object with the paragraph
Dim doc As New WordDocument(paragraph)

' Save the document as a .docx file
doc.SaveAs("example.docx") ' Saves the file to disk with the name example.docx

Yukarıdaki kod örneği çalıştırıldıktan sonra, yeni belge dosyası example.docx oluşturulur ve çıktı aşağıda gösterildiği gibidir.

Bu, IronWord kullanarak bir Word belge dosyası üretmenin temel bir örneğidir. Daha fazla bilgi için, Dokümantasyon'u okuyabilirsiniz.

Bir Word Belgesine Stil ile Paragraflar Ekleme

Artık IronWord kullanarak nasıl basit bir Word belgesi oluşturulacağını bildiğimize göre, paragraflar ve stilize edilmiş metin ekleyelim.

TextRun ayrıca stil verileri alabilir ve metnin görsel temsilini geliştirir. Metin, üstü çizgili, kalın, italik ve altı çizili gibi stil ile ayarlanabilir.

Önceden yaptığınız programa aşağıdaki kodu ekleyin ve değiştirin.

using IronWord;
using IronWord.Models;

// Create text runs with different styles
TextRun textRun = new TextRun("Hello, World!"); // Simple string
Paragraph paragraph = new Paragraph();
paragraph.AddTextRun(textRun);

// Configure and add italic text
TextRun introText = new TextRun("This is an example paragraph with italic and bold styling.");
TextStyle italicStyle = new TextStyle()
{
    IsItalic = true
};
TextRun italicText = new TextRun("Italic example sentence.", italicStyle);

// Configure and add bold text
TextStyle boldStyle = new TextStyle()
{
    IsBold = true
};
TextRun boldText = new TextRun("Bold example sentence.", boldStyle);

// Add text runs to the paragraph
paragraph.AddTextRun(introText);
paragraph.AddTextRun(italicText);
paragraph.AddTextRun(boldText);

// Create and save the new Word document
WordDocument doc = new WordDocument(paragraph);
doc.SaveAs("example.docx"); // Saves the file to disk with the name example.docx

using IronWord;
using IronWord.Models;

// Create text runs with different styles
TextRun textRun = new TextRun("Hello, World!"); // Simple string
Paragraph paragraph = new Paragraph();
paragraph.AddTextRun(textRun);

// Configure and add italic text
TextRun introText = new TextRun("This is an example paragraph with italic and bold styling.");
TextStyle italicStyle = new TextStyle()
{
    IsItalic = true
};
TextRun italicText = new TextRun("Italic example sentence.", italicStyle);

// Configure and add bold text
TextStyle boldStyle = new TextStyle()
{
    IsBold = true
};
TextRun boldText = new TextRun("Bold example sentence.", boldStyle);

// Add text runs to the paragraph
paragraph.AddTextRun(introText);
paragraph.AddTextRun(italicText);
paragraph.AddTextRun(boldText);

// Create and save the new Word document
WordDocument doc = new WordDocument(paragraph);
doc.SaveAs("example.docx"); // Saves the file to disk with the name example.docx

Imports IronWord
Imports IronWord.Models

' Create text runs with different styles
Private textRun As New TextRun("Hello, World!") ' Simple string
Private paragraph As New Paragraph()
paragraph.AddTextRun(textRun)

' Configure and add italic text
Dim introText As New TextRun("This is an example paragraph with italic and bold styling.")
Dim italicStyle As New TextStyle() With {.IsItalic = True}
Dim italicText As New TextRun("Italic example sentence.", italicStyle)

' Configure and add bold text
Dim boldStyle As New TextStyle() With {.IsBold = True}
Dim boldText As New TextRun("Bold example sentence.", boldStyle)

' Add text runs to the paragraph
paragraph.AddTextRun(introText)
paragraph.AddTextRun(italicText)
paragraph.AddTextRun(boldText)

' Create and save the new Word document
Dim doc As New WordDocument(paragraph)
doc.SaveAs("example.docx") ' Saves the file to disk with the name example.docx

Bir Word Belgesine Tablo Ekleme

Verilerin net temsili için, bir ızgara içinde de temsil edilebilir. Veriler, bir ızgara şeklinde düzenlendiğinde, buna tablo denir. IronWord kullanarak, aşağıda gösterildiği gibi Word belgesine tablolar ve resimler ekleyebiliriz:

using IronWord;
using IronWord.Models;

// Create a table cell with sample text
TableCell cell = new TableCell();
TextRun textRun = new TextRun("Sample text");

// Add text run to the cell as a paragraph
cell.AddContent(new Paragraph(textRun));

// Configure cell border style
BorderStyle borderStyle = new BorderStyle
{
    BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
    BorderValue = IronWord.Models.Enums.BorderValues.Thick,
    BorderSize = 5
};

// Set table borders
TableBorders tableBorders = new TableBorders
{
    TopBorder = borderStyle,
    RightBorder = borderStyle,
    BottomBorder = borderStyle,
    LeftBorder = borderStyle
};
cell.Borders = tableBorders;

// Create a table row and add cells to it
TableRow row = new TableRow();
row.AddCell(cell); // Add the first cell
row.AddCell(cell); // Add the second cell, duplicating to mimic a row with two identical cells

// Create a table and add the row to the table
Table table = new Table();
table.AddRow(row);

// Create and save a Word document using the table
WordDocument doc = new WordDocument(table);
doc.SaveAs("Document.docx"); // Saves the file to disk with the name Document.docx

using IronWord;
using IronWord.Models;

// Create a table cell with sample text
TableCell cell = new TableCell();
TextRun textRun = new TextRun("Sample text");

// Add text run to the cell as a paragraph
cell.AddContent(new Paragraph(textRun));

// Configure cell border style
BorderStyle borderStyle = new BorderStyle
{
    BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
    BorderValue = IronWord.Models.Enums.BorderValues.Thick,
    BorderSize = 5
};

// Set table borders
TableBorders tableBorders = new TableBorders
{
    TopBorder = borderStyle,
    RightBorder = borderStyle,
    BottomBorder = borderStyle,
    LeftBorder = borderStyle
};
cell.Borders = tableBorders;

// Create a table row and add cells to it
TableRow row = new TableRow();
row.AddCell(cell); // Add the first cell
row.AddCell(cell); // Add the second cell, duplicating to mimic a row with two identical cells

// Create a table and add the row to the table
Table table = new Table();
table.AddRow(row);

// Create and save a Word document using the table
WordDocument doc = new WordDocument(table);
doc.SaveAs("Document.docx"); // Saves the file to disk with the name Document.docx

Imports IronWord
Imports IronWord.Models

' Create a table cell with sample text
Private cell As New TableCell()
Private textRun As New TextRun("Sample text")

' Add text run to the cell as a paragraph
cell.AddContent(New Paragraph(textRun))

' Configure cell border style
Dim borderStyle As New BorderStyle With {
	.BorderColor = New IronColor(IronSoftware.Drawing.Color.Black),
	.BorderValue = IronWord.Models.Enums.BorderValues.Thick,
	.BorderSize = 5
}

' Set table borders
Dim tableBorders As New TableBorders With {
	.TopBorder = borderStyle,
	.RightBorder = borderStyle,
	.BottomBorder = borderStyle,
	.LeftBorder = borderStyle
}
cell.Borders = tableBorders

' Create a table row and add cells to it
Dim row As New TableRow()
row.AddCell(cell) ' Add the first cell
row.AddCell(cell) ' Add the second cell, duplicating to mimic a row with two identical cells

' Create a table and add the row to the table
Dim table As New Table()
table.AddRow(row)

' Create and save a Word document using the table
Dim doc As New WordDocument(table)
doc.SaveAs("Document.docx") ' Saves the file to disk with the name Document.docx

Yukarıdaki örnekte, kenarlıklarla bir Word belgesine bir tablo eklediğimizi gösterdik.

Bir Word Belgesine Resim Ekleme

Resimler, belgenin sunumunu geliştirir ve daha fazla renk ve görsel çekicilik ekleyebilir.

Aşağıdaki kodda gösterildiği gibi, IronWord kullanarak programlı olarak bir Word belgesine resimler eklenebilir:

using IronWord;
using IronWord.Models;

// Load a new document
WordDocument doc = new WordDocument();

// Configure and add image to the document
IronWord.Models.Image image = new IronWord.Models.Image("SalesChart.jpg")
{
    Width = 200, // Set image width in pixels
    Height = 200 // Set image height in pixels
};
Paragraph paragraph = new Paragraph();
paragraph.AddImage(image); // Add image to paragraph
doc.AddParagraph(paragraph); // Add paragraph to the document

// Save the document as a .docx file
doc.SaveAs("save_document.docx"); // Saves the file to disk with the name save_document.docx

using IronWord;
using IronWord.Models;

// Load a new document
WordDocument doc = new WordDocument();

// Configure and add image to the document
IronWord.Models.Image image = new IronWord.Models.Image("SalesChart.jpg")
{
    Width = 200, // Set image width in pixels
    Height = 200 // Set image height in pixels
};
Paragraph paragraph = new Paragraph();
paragraph.AddImage(image); // Add image to paragraph
doc.AddParagraph(paragraph); // Add paragraph to the document

// Save the document as a .docx file
doc.SaveAs("save_document.docx"); // Saves the file to disk with the name save_document.docx

Imports IronWord
Imports IronWord.Models

' Load a new document
Private doc As New WordDocument()

' Configure and add image to the document
Private image As New IronWord.Models.Image("SalesChart.jpg") With {
	.Width = 200,
	.Height = 200
}
Private paragraph As New Paragraph()
paragraph.AddImage(image) ' Add image to paragraph
doc.AddParagraph(paragraph) ' Add paragraph to the document

' Save the document as a .docx file
doc.SaveAs("save_document.docx") ' Saves the file to disk with the name save_document.docx

Burada, bir paragraf içine IronWord.Models.Image kullanarak 200 piksel Yükseklik ve Genişlik ile bir resim ekliyoruz.

{
    "IronWord.LicenseKey": "IRONWORD.MYLICENSE.KEY.TRIAL"
}

Sonuç

C# kullanarak IronWord kütüphanesi ile Word belgeleri oluşturmak, Microsoft Office'e bağlı kalmadan belge oluşturma için esnek ve etkili bir yol sağlar. İster basit mektuplar ister tablolar ve resimlerle karmaşık raporlar oluşturmanız gereksin, IronWord bunu programlı olarak gerçekleştirmenizi sağlar. Bu makale, Word belgeleri oluşturma konusunda kapsamlı bir öğretici sunmaktadır. IronWord ile, Word belgelerinin oluşturulmasını otomatikleştirme gücüne sahipsiniz, bu da C# uygulamalarınızı daha çok yönlü ve üretken hale getirir.

Ve oluşturulan Word belgeleriyle birlikte çalışacak PDF dosyası manipülasyonu arayan geliştiriciler için, Iron Software tarafından üretilmiş başka bir C# kitaplığı olan IronPDF'a daha fazla bakmayın.