.NET Word API, geliştiricilere Word belgelerini dönüştürme, uygulamaları içinde MS Word belgeleriyle etkileşime geçme ve manipüle etme konusunda güçlü araçlar sunar. Bu API, Microsoft Word belgeleri ile çalışma sürecini basitleştirmek için tasarlanmış olup, belgeleri programatik olarak oluşturmayı, düzenlemeyi, dönüştürmeyi ve yönetmeyi kolaylaştırır. Bu makalede, Word belgelerini manipüle etme yeteneklerini anlamak için IronWord kütüphanesini inceleyeceğiz.

IronWord'e Giriş

IronWord, özellikle .NET uygulamalarında Microsoft Word belgelerini işleyen geliştiriciler için tasarlanmış .NET Word API ekosisteminde bir .NET Word kütüphanesidir. IronWord ile geliştiriciler, sunucu veya istemci makinelerinde Microsoft Word yüklü olmadan Word belgelerini kolayca okuyabilir, yazabilir ve değiştirebilir. Bu yetenek, raporlar, faturalar veya posta birleştirme işlevleri aracılığıyla özelleştirilmiş yazışmalar gibi belge işleme görevlerini otomatikleştirmesi gereken uygulamalar için özellikle faydalıdır.

IronWord'un Özellikleri

IronWord, Word belgesi manipülasyonunun çeşitli yönlerine hitap eden kapsamlı bir özellik yelpazesi sunar. 'Belge Yapısı' ve 'Belge Elemanları' başlığı altında kategorize edilen birden fazla belgenin manipülasyonu ve birleştirilmesine nasıl olanak sağladıklarına odaklanarak her bir özellik setini keşfedelim.

Belge Yapısı

Word'u Oku ve Düzenle: IronWord ile belgelerinizden metin çıkararak düzenleme veya yeniden kullanma, başka yerlere kullanılabilecek resimleri alma gibi özel bilgileri çıkartabilirsiniz. Bu yetenek, DOCX dosyalarındaki bilgileri işlemeyi ve Word belgelerini birleştirmeyi hedefleyen uygulamalar için hayati önem taşır.

Birçok Format: IronWord, .NET uygulamaları içinde Word belgelerini dönüştürmek için geniş bir dosya formatı yelpazesini destekleyerek faydasını artırır.

Sayfa Ayarlarını Düzenleme: Word belgelerinizin fiziksel düzenini özelleştirmek IronWord ile oldukça basittir. Belirli MS Word dosyaları için kağıt boyutunu standart veya özel boyutlara ayarlayabilirsiniz, belgelerinizin farklı bölümleri için yönü değiştirebilir, uygun hizalama sağlamak için kenar boşluklarını ayarlayabilir ve hatta estetik amaçlar için veya bazı bölümleri vurgulamak için arka plan rengini değiştirebilirsiniz.

Paragraflar Ekle: IronWord, büyük metin bölümlerini düzenlemek ve biçimlendirmek için paragraflar içindeki metin dizileri eklemenize ve kaldırmanıza olanak tanır. Ayrıca paragraflarınızı metin içine doğrudan resim ve şekiller ekleyerek geliştirebilir, tasarım özelliklerinize uygun, kütuplara göre ayarlamalar yapıp düzgün bir görünüm için hizalamalar yaparak geliştirebilirsiniz. Maddeler ve numaralandırma listeleri ekleme yeteneği, içeriği daha etkili bir şekilde organize etmenize yardımcı olur.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Load docx
        WordDocument doc = new WordDocument();
        // Create and add styled text to a paragraph
        Paragraph paragraph = new Paragraph();
        
        // Adding regular text
        paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));
        
        // Adding italic text
        paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));
        
        // Adding bold text
        paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));
        
        // Add paragraph to the document and export docx
        doc.AddParagraph(paragraph);
        doc.SaveAs("newdocument.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Load docx
        WordDocument doc = new WordDocument();
        // Create and add styled text to a paragraph
        Paragraph paragraph = new Paragraph();
        
        // Adding regular text
        paragraph.AddTextRun(new TextRun("Exploring text styles within a document."));
        
        // Adding italic text
        paragraph.AddTextRun(new TextRun("An example in italic.", new TextStyle { IsItalic = true }));
        
        // Adding bold text
        paragraph.AddTextRun(new TextRun("An example in bold.", new TextStyle { IsBold = true }));
        
        // Add paragraph to the document and export docx
        doc.AddParagraph(paragraph);
        doc.SaveAs("newdocument.docx");
    }
}

Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        ' Load docx
        Dim doc As New WordDocument()
        ' Create and add styled text to a paragraph
        Dim paragraph As New Paragraph()
        
        ' Adding regular text
        paragraph.AddTextRun(New TextRun("Exploring text styles within a document."))
        
        ' Adding italic text
        paragraph.AddTextRun(New TextRun("An example in italic.", New TextStyle With {.IsItalic = True}))
        
        ' Adding bold text
        paragraph.AddTextRun(New TextRun("An example in bold.", New TextStyle With {.IsBold = True}))
        
        ' Add paragraph to the document and export docx
        doc.AddParagraph(paragraph)
        doc.SaveAs("newdocument.docx")
    End Sub
End Module

Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        ' Load docx
        Dim doc As New WordDocument()
        ' Create and add styled text to a paragraph
        Dim paragraph As New Paragraph()
        
        ' Adding regular text
        paragraph.AddTextRun(New TextRun("Exploring text styles within a document."))
        
        ' Adding italic text
        paragraph.AddTextRun(New TextRun("An example in italic.", New TextStyle With {.IsItalic = True}))
        
        ' Adding bold text
        paragraph.AddTextRun(New TextRun("An example in bold.", New TextStyle With {.IsBold = True}))
        
        ' Add paragraph to the document and export docx
        doc.AddParagraph(paragraph)
        doc.SaveAs("newdocument.docx")
    End Sub
End Module

Tablolar Ekle: Tablolar, DOCX dosyalarının kritik bir bileşenidir ve dinamik belge oluşturmayı destekleyen IronWord ile kolaylıkla manipüle edilebilir. Verilerin miktarının değişebileceği dinamik belge oluşturma anahtarı olan satırların ve sütunların eklenip kaldırılması işlemi gerçekleştirilebilir. Hücrelerin birleştirilmesi ve ayrılması, karmaşık tabloları biçimlendirmek için size çeşitlilik sağlar ve sınırları ve düzen boyutunu özelleştirme, cilalı ve profesyonel bir görünüm sağlar.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a table cell with a paragraph containing text
        TableCell cell = new TableCell(new Paragraph(new TextRun("Sample text")));
        
        // Configure a common border style for the table
        BorderStyle borderStyle = new BorderStyle
        {
            BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
            BorderValue = IronWord.Models.Enums.BorderValues.Thick,
            BorderSize = 5
        };
        
        // Apply the border style to the cell
        cell.Borders = new TableBorders
        {
            TopBorder = borderStyle,
            RightBorder = borderStyle,
            BottomBorder = borderStyle,
            LeftBorder = borderStyle
        };
        
        // Create a table row and add the same cell twice
        TableRow row = new TableRow();
        row.AddCell(cell);
        row.AddCell(cell);
        
        // Create a table, add the row, then create and export the Word document
        Table table = new Table();
        table.AddRow(row);
        WordDocument doc = new WordDocument(table);
        doc.SaveAs("Document.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a table cell with a paragraph containing text
        TableCell cell = new TableCell(new Paragraph(new TextRun("Sample text")));
        
        // Configure a common border style for the table
        BorderStyle borderStyle = new BorderStyle
        {
            BorderColor = new IronColor(IronSoftware.Drawing.Color.Black),
            BorderValue = IronWord.Models.Enums.BorderValues.Thick,
            BorderSize = 5
        };
        
        // Apply the border style to the cell
        cell.Borders = new TableBorders
        {
            TopBorder = borderStyle,
            RightBorder = borderStyle,
            BottomBorder = borderStyle,
            LeftBorder = borderStyle
        };
        
        // Create a table row and add the same cell twice
        TableRow row = new TableRow();
        row.AddCell(cell);
        row.AddCell(cell);
        
        // Create a table, add the row, then create and export the Word document
        Table table = new Table();
        table.AddRow(row);
        WordDocument doc = new WordDocument(table);
        doc.SaveAs("Document.docx");
    }
}

Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        ' Create a table cell with a paragraph containing text
        Dim cell As New TableCell(New Paragraph(New TextRun("Sample text")))

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

        ' Apply the border style to the cell
        cell.Borders = New TableBorders With {
            .TopBorder = borderStyle,
            .RightBorder = borderStyle,
            .BottomBorder = borderStyle,
            .LeftBorder = borderStyle
        }

        ' Create a table row and add the same cell twice
        Dim row As New TableRow()
        row.AddCell(cell)
        row.AddCell(cell)

        ' Create a table, add the row, then create and export the Word document
        Dim table As New Table()
        table.AddRow(row)
        Dim doc As New WordDocument(table)
        doc.SaveAs("Document.docx")
    End Sub
End Module

Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        ' Create a table cell with a paragraph containing text
        Dim cell As New TableCell(New Paragraph(New TextRun("Sample text")))

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

        ' Apply the border style to the cell
        cell.Borders = New TableBorders With {
            .TopBorder = borderStyle,
            .RightBorder = borderStyle,
            .BottomBorder = borderStyle,
            .LeftBorder = borderStyle
        }

        ' Create a table row and add the same cell twice
        Dim row As New TableRow()
        row.AddCell(cell)
        row.AddCell(cell)

        ' Create a table, add the row, then create and export the Word document
        Dim table As New Table()
        table.AddRow(row)
        Dim doc As New WordDocument(table)
        doc.SaveAs("Document.docx")
    End Sub
End Module

Belge Elemanları

Metin Dizileri Ekleyin: Bu özellik, metin içeriği üzerinde ince taneli kontrol sağlar. Metin dizileri ekleyebilir, bağlayabilir ve ayırabilir, bu da dinamik belge oluşturma için önemlidir. Stil seçenekleri geniş kapsamlıdır, yazı tipi ailelerini, boyutlarını ve renklerini değiştirme, ayrıca kalın, italik ve diğer metin süslemeleri eklemeyi içerir. Metin dizileri içinde resimler de gömülebilir, böylece zengin, görsel olarak ilgi çekici bir belge oluşturulabilir.

Resimler Ekleyin: IronWord, Word Belgeleri içinde kapsamlı görüntü manipülasyonu sağlar. Çeşitli kaynaklardan resimleri yükleyebilir, metni etrafında sorunsuz bir şekilde sarabilir ve yerleşiminize uygun boyutlarla ayarlamasını yapabilirsiniz. Pozisyon ofsetini ayarlama ve belge köşelerinden olan uzaklığı ayarlama yeteneği, resimlerinizin her zaman mükemmel konumlandırılmasını sağlar.

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        WordDocument doc = new WordDocument();
        
        // Load and configure the image
        IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
        {
            Width = 200, // In unit pixels
            Height = 200 // In unit pixels
        };
        
        // Create paragraph, add image, add paragraph to document, and export
        Paragraph paragraph = new Paragraph();
        paragraph.AddImage(image);
        
        // Add paragraph containing the image to the document
        doc.AddParagraph(paragraph);
        doc.SaveAs("save_document.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        WordDocument doc = new WordDocument();
        
        // Load and configure the image
        IronWord.Models.Image image = new IronWord.Models.Image("your-image.jpg")
        {
            Width = 200, // In unit pixels
            Height = 200 // In unit pixels
        };
        
        // Create paragraph, add image, add paragraph to document, and export
        Paragraph paragraph = new Paragraph();
        paragraph.AddImage(image);
        
        // Add paragraph containing the image to the document
        doc.AddParagraph(paragraph);
        doc.SaveAs("save_document.docx");
    }
}

Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        Dim doc As New WordDocument()
        
        ' Load and configure the image
        Dim image As New IronWord.Models.Image("your-image.jpg") With {
            .Width = 200, ' In unit pixels
            .Height = 200 ' In unit pixels
        }
        
        ' Create paragraph, add image, add paragraph to document, and export
        Dim paragraph As New Paragraph()
        paragraph.AddImage(image)
        
        ' Add paragraph containing the image to the document
        doc.AddParagraph(paragraph)
        doc.SaveAs("save_document.docx")
    End Sub
End Module

Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        Dim doc As New WordDocument()
        
        ' Load and configure the image
        Dim image As New IronWord.Models.Image("your-image.jpg") With {
            .Width = 200, ' In unit pixels
            .Height = 200 ' In unit pixels
        }
        
        ' Create paragraph, add image, add paragraph to document, and export
        Dim paragraph As New Paragraph()
        paragraph.AddImage(image)
        
        ' Add paragraph containing the image to the document
        doc.AddParagraph(paragraph)
        doc.SaveAs("save_document.docx")
    End Sub
End Module

Şekiller Ekleyin: Şekiller bir belgeye önemli görsel etki sağlayabilir ve IronWord size bunları hassas bir şekilde yerleştirme ve özelleştirme araçları sağlar. Şekil tipini (dikdörtgenler, daireler, oklar vb. gibi) ayarlayabilir, metnin şeklin etrafında nasıl sarılması gerektiğini belirleyebilir, kesin boyutları ve pozisyonlamayı belirleyebilir ve hatta istenilen görsel etkiyi elde etmek için şekilleri döndürebilirsiniz.

Uyumluluk

.NET Sürümleri ve Proje Türleri

IronWord, .NET ekosisteminde geniş uyumluluk için tasarlanmıştır, çeşitli .NET sürümleri, C#, VB.NET ve F#'ı destekler, bunlar arasında .NET Core, .NET Standard ve .NET Framework bulunmaktadır. Bu, hem çağdaş hem de eski uygulamalarda kullanımını garanti eder. Kütüphanenin çok yönlülüğü, Blazor, WebForms, Xamarin, MAUI, WPF ve konsol uygulamaları entegrasyonlarıyla web, mobil ve masaüstü uygulamaları da kapsayacak şekilde genişletilir.

Uygulama Ortamları

Uygulama ortamları açısından, IronWord, Docker, Azure ve AWS'de özel olarak kapsayıcılaştırma ve bulut dağıtımı desteği dahil olmak üzere Windows, Linux, iOS ve Android platformlarına uyum sağlar. Bu geniş kapsamlı destek, farklı ortamlar arasında geliştirmeyi kolaylaştırır.

OS ve IDE

IronWord ayrıca Microsoft Visual Studio, ReSharper ve Rider gibi büyük Entegre Geliştirme Ortamları ile uyumludur, geliştiricilere araç seçimlerinde esneklik sağlar. Son olarak, çeşitli işletim sistemleri ve işlemci mimarilerine (x64, x86, ARM) uyumlu olup, çeşitli donanım yapılandırmaları arasında verimli performans sağlar.

Lisanslama Seçenekleri

IronWord, farklı geliştirici ve organizasyonların ihtiyaçlarını karşılamak için çeşitli lisanslama seçenekleri sunar. Süresiz lisans sunarlar, yani bir kere ödeme yaparsınız ve tekrar eden ücretler yoktur. Her lisans, bir yıl ürün desteği ve güncellemeleri içerir. Lisanslama katmanları geliştirici sayısına, konumlarına ve projelerinize göre tasarlanmıştır. Bir lisans satın almadan önce, ücretsiz deneme alarak eklenti deneyimini yaşayabilirsiniz.

Lite Lisans

Bu seçenek, bir projede tek başına çalışan bireysel geliştiriciler için özel olarak hazırlanmıştır. Fiyatı $999 olup tek bir konumda bir geliştiriciyi kapsar.

Plus Lisans

Küçük takımlar için tasarlanan bu lisans, $1,499'tan fiyatlandırılmış olup, üç geliştiriciye kadar uyar ve üç proje boyunca üç konumda kullanılabilirlik sunar.

Professional Lisans

Daha büyük takımlar için, Professional Lisans $2,399'a fiyatlandırılmış olup, on geliştiriciye kadar destekler. Daha kapsamlı operasyonları kapsamak için tasarlanmış olup, premium destek özellikleri içerir.

Sonuç

Sonuç olarak, IronWord, bireysel geliştiriciler ve takımların farklı ihtiyaçlarını karşılayan lisanslama seçenekleri sunan, sağlam ve esnek bir .NET Word API olarak öne çıkıyor. Özellikleri, Word belgelerinin verimli bir şekilde yönetilmesini ve manipüle edilmesini sağlar ve çeşitli .NET sürümleri ve proje türleri arasında uyumluluğu sağlar.