C#'da Office Interop Kullanmadan Word Belgeleri Nasil Oluşturulur

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 mevcut 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üklü olduğundan emin olun.
2. NuGet Paket Yöneticisi: Projenizde paketleri yönetmek için NuGet'i kullanabileceğinizden emin olun.

Adım 1: Yeni Bir C# Projesi Oluşturun

Yeni bir C# konsol uygulaması oluşturun veya Word belgesi oluşturmak istediğiniz mevcut bir proje kullanın.

Konsol uygulaması şablonunu seçin ve ileri'ye tıklayın.

Sonraki adımda çözüm ve proje isimleri tanımlayabilirsiniz.

.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üphanesi Kullanarak Bir Word Belgesi Oluşturma ve Kaydetme

IronWord kütüphanesini kullanarak bir Word belgesi oluşturmanın basit bir örneğiyle başlayalım. Aşağıdaki kod, "Merhaba, Dünya!" metnini içeren tek bir paragrafla temel bir Word belgesi oluşturmayı 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 yürütüldüğünde, yeni belge dosyası example.docx oluşturulur ve çıktı aşağıda gösterildiği gibidir.

Bu, IronWord kullanarak bir Word belge dosyası oluşturmanın temel bir örneğidir. Daha fazla bilgi için, Dokümantasyon okuyabilirsiniz.

Bir Word Belgesine Stil ile Paragraflar Ekleme

IronWord kullanarak basit bir Word belgesi nasıl oluşturulacağını öğrendik, şimdi paragraflar ve stilli metin ekleyelim.

TextRun da stil verilerini alabilir, metnin görsel temsilini geliştirir. Metin, üstü çizili, kalın, italik ve altı çizili gibi stillerle ayarlanabilir.

Aşağıdaki kodu daha önce yaptığınız programa 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 bir şekilde gösterilmesi için, ayrıca bir ızgara halinde gösterilebilir. Veriler ızgara halinde düzenlendiğinde, buna tablo denir. IronWord kullanarak tablo ve görüntüleri Word belgesine aşağıda gösterildiği gibi 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, bir Word belgesine sınırlar kullanarak bir tablo ekledik.

Bir Word Belgesine Görüntüler Ekleme

Görüntüler belgenin sunumunu zenginleştirir ve daha fazla renk ve görsel çekicilik katabilir.

Görüntüler, IronWord kullanılarak programatik olarak bir Word belgesine aşağıda gösterilen kodla 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 paragrafa 200 piksel Yükseklik ve Genişlik ile IronWord.Models.Image kullanarak bir resim ekliyoruz.

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

Sonuç

IronWord kütüphanesini kullanarak C#'ta Word belgeleri oluşturmak, belgeleri Microsoft Office'e güvenmeden esnek ve etkili bir şekilde oluşturmanın yolunu sunar. İster basit mektuplar ister tablolar ve görüntüler içeren karmaşık raporlar oluşturmanız gereksin, IronWord bunu programatik olarak yapmanıza olanak tanır. Bu makale, Word belgeleri oluşturmak için kapsamlı bir öğretici sunar. IronWord ile Word belgelerinin oluşturulmasını otomatikleştirebilir, C# uygulamalarınızı daha çeşitli ve üretken hale getirebilirsiniz.

Ve oluşturulan Word belgelerinizle birlikte çalışmak için PDF dosya manipülasyonu arayan geliştiriciler, Iron Software tarafından üretilmiş başka bir C# kütüphanesi olan IronPDF ile tanışın.