C# Kullanarak Bir Word Belgesi Nasil Manipüle Edilir

How To Manipulate Word Document Using C

1. Sifirdan yeni bir Visual Studio projelerini başlatin.
2. Word dokümanlarini okumak icin gerekli kutuphaneyi kurun.
3. Bir Word dokümanini manipule etmek icin mevcut bir dosya yukleyin veya yeni bir dosya oluşturun.
4. Doküman verilerini duzenleyin ve dosyayi arayin.
5. Oluşturulan tüm nesnelerden kurtulun.

Microsoft Interop Nedir?

C# veya VB.NET ile yazilmis programlar, Office Interoperability ile Microsoft Word dokümanlarini (DOC, DOCX ve RTF) oluşturabilir veya acabilir. Ancak projelerde kullanildiginda bircok dezavantaji vardir.

Bu makalede, C# veya VB.NET'ten Microsoft Office Interop (Word Automation) kullanirken karsilasabileceginiz yaygin sorunlari tartisacagiz.

Örneğin:

• Sozluk otomasyonu icin gereken her müşteri PC'si icin Microsoft Word lisansli olmalidir.
• Her müşteri'nin PC'sinde, ayni Microsoft Word sürümü yüklü olmalıdır.
• Word, arka planda birden fazla dosya ve DLL yüklemek için birkaç megabayt RAM kullanir.
• Microsoft Word API'sine bir COM nesnesi araciligiyla erisilir. Yönetilen koddan bir COM nesnesini çagirdiginizda, tür dönüştürmeleri, bir COM wrapper gereksinimi ve yetersiz .NET Framework entegrasyonu gibi sorunlar ortaya çikabilir.

Visual Studio'da Yeni Proje Oluşturma

Install-Package Microsoft.Office.Interop.Word

Mevcut Word Belgelerini Interop Kullanarak Manipule Etme

Microsoft Word kullanmak için önce bir Microsoft.Office.Interop.Word.Application örneği oluşturmalısınız. Word dokümanlarinin iletimi bu durumda gerceklesecektir. Sonraki adım, az önce oluşturduğumuz Microsoft.Office.Interop.Word.Application örneğinin Documents özelliğini kullanarak yeni bir Word belgesi örneği oluşturmaktır. Asagidaki C# kod parcasinda görüldüğü gibi, bu, Word belgelerini programlamalı olarak değiştirmemize olanak tanır:

using System;
using Microsoft.Office.Interop.Word;

class Program
{
    static void Main()
    {
        try
        {
            // Create a new instance of Word Application
            var WordApp = new Microsoft.Office.Interop.Word.Application();
            // Open an existing document
            var WordDoc = WordApp.Documents.Open(@"d:/Demo.docx");
            // Edit the content of the first paragraph
            WordDoc.Paragraphs[1].Range.Text = "New text here...";
            // Save the edited document
            WordDoc.SaveAs(@"d:/NewDemo.docx");
            // Close the document
            WordDoc.Close();
            // Quit the Word application
            WordApp.Quit();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.ToString());
        }
    }
}

using System;
using Microsoft.Office.Interop.Word;

class Program
{
    static void Main()
    {
        try
        {
            // Create a new instance of Word Application
            var WordApp = new Microsoft.Office.Interop.Word.Application();
            // Open an existing document
            var WordDoc = WordApp.Documents.Open(@"d:/Demo.docx");
            // Edit the content of the first paragraph
            WordDoc.Paragraphs[1].Range.Text = "New text here...";
            // Save the edited document
            WordDoc.SaveAs(@"d:/NewDemo.docx");
            // Close the document
            WordDoc.Close();
            // Quit the Word application
            WordApp.Quit();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.ToString());
        }
    }
}

Imports System
Imports Microsoft.Office.Interop.Word

Friend Class Program
	Shared Sub Main()
		Try
			' Create a new instance of Word Application
			Dim WordApp = New Microsoft.Office.Interop.Word.Application()
			' Open an existing document
			Dim WordDoc = WordApp.Documents.Open("d:/Demo.docx")
			' Edit the content of the first paragraph
			WordDoc.Paragraphs(1).Range.Text = "New text here..."
			' Save the edited document
			WordDoc.SaveAs("d:/NewDemo.docx")
			' Close the document
			WordDoc.Close()
			' Quit the Word application
			WordApp.Quit()
		Catch ex As Exception
			Console.WriteLine(ex.ToString())
		End Try
	End Sub
End Class

Yukarıdaki kodda, Word belgesini C# dilinde düzenleyebiliyoruz. İlk olarak, Interop kullanarak Word uygulamasının bir örneğini oluşturuyoruz. Ardından Open yöntemi kullanılarak mevcut bir Word dosyası açılır ve belge nesnesine dönüştürülür. Daha sonra, belgelerle etkileşimde bulunmak için uygun olan çeşitli özelliklere ve yöntemlere erişim sağlayabiliriz. Örnekte, ilk paragrafın metni, hangi paragrafın düzenleneceğini belirtmek için bir dizin ve Paragraphs koleksiyonu kullanılarak güncellenir. Son olarak, değişiklikler SaveAs ile kaydedilir ve belge ile uygulama düzgün bir şekilde kapatılır.

Interop'a Alternatif IronXL Kutuphanesi

IronXL, .NET programlarinda Excel dosyalarını işlemek icin kullanilabilecek, Microsoft Interop'a alternatif bir yaklasimdir. Microsoft Interop, Interop kutuphaneleri araciligiyla Excel ile etkileşim kurmayı gerektirirken, IronXL, .NET bağlamlarında Excel dosyalarını programlamalı olarak düzenlemek için daha doğrudan, etkili ve güçlü bir yöntem sunar.

Microsoft Interop yerine IronXL kullanmanin bircok faydasi vardir, bunlar:

• Performans ve Kaynak Verimliligi: Bilgisayarda Excel uygulamasının yüklü olmasına dayanan Microsoft Interop'a kıyasla, IronXL daha iyi performans gösterir ve Excel uygulamasına bağımlı olmadığından daha az kaynak kullanır.
• Kullanım Kolaylığı ve Basitlik: IronXL, Excel dosyalarını okuma, yazma ve değiştirme işlemlerini Microsoft Interop ile ilgili karmaşıklıklar olmadan basitleştiren daha kolay kullanımlı bir API sağlar.
• Uyumluluk ve Bağımlılık: Microsoft Excel'in bilgisayara yüklenmesini gerektirmeyerek, çeşitli Excel veya Office sürümleriyle oluşabilecek bağımlılık ve uyum problemlerini ortadan kaldırır.
• Platform Bağımsızlığı: Belirli Microsoft Office sürümleriyle daha yakından ilişkili olabilecek Microsoft Interop'un aksine, IronXL, çeşitli ortam ve platformlarda dağıtım esnekliği ve kolaylığı sunar.

Excel dosyalarıyla programatik olarak çalışmaları gerekli olan .NET geliştiricileri için, IronXL, kullanım kolaylığı, hız ve üçüncü taraf yazılım kurulumlarına olan azaltılmış bağımlılığı nedeniyle genellikle daha iyi bir seçenektir. IronXL ve Microsoft Interop arasinda karar verirken, proje özellikleri, mevcut altyapi ve her bir kutuphane ile kullanicinin uzmanlik seviyesinin etkili olabilecegi ihtimaline karsi dikkatli olun.

Bu seçeneklerden birini secmeden once uygulamanizin gereksinimlerini her zaman dusunun. IronXL kutuphanesi hakkında daha fazla bilgi için bu bağlantıya göz atın.

IronXL Kütüphanesini Yükleme

Gelecek yamaya ihtiyaçınız için IronXL kütüphanesini kurun. Bunu tamamlamak için, NuGet Paket Yöneticisi Konsolunu açın ve aşağıdaki komutu yazın:

Install-Package IronWord

IronXL paketini NuGet Paket Yöneticisi üzerinden aramak başka bir seçenektir. IronXL ile bağlantılı tüm NuGet paketlerinden ihtiyaçımız olanı indirmek için seçebiliriz.

IronXL Kullanarak Excel Belgelerini Duzenleme

Veriler, sadece birkac satir kodla XLSX veya XLS formatlarina export edilebilir. Asagidaki kaynak kod orneği, verilerin bir Excel dosyasından basit bir tablo formatına nasıl eksport edilebileceğini gösterir:

using IronXL;

class Program
{
    static void Main()
    {
        // Load an existing Excel file
        var workbook = WorkBook.Load("Demo file.xlsx");
        // Access the first sheet or the sheet by name
        var ws = workbook.GetWorkSheet("Sheet1");
        // Read a value from a cell and output it to the console
        string address_val = ws["A1"].ToString();
        Console.WriteLine(address_val);
        // Modify a cell's value
        ws["A2"].Value = "Hello World";
        // Save the workbook to different formats
        workbook.SaveAs("export.xlsx");
        workbook.SaveAs("export.xls");
        workbook.WorkSheets[0].SaveAs("export.xls");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load an existing Excel file
        var workbook = WorkBook.Load("Demo file.xlsx");
        // Access the first sheet or the sheet by name
        var ws = workbook.GetWorkSheet("Sheet1");
        // Read a value from a cell and output it to the console
        string address_val = ws["A1"].ToString();
        Console.WriteLine(address_val);
        // Modify a cell's value
        ws["A2"].Value = "Hello World";
        // Save the workbook to different formats
        workbook.SaveAs("export.xlsx");
        workbook.SaveAs("export.xls");
        workbook.WorkSheets[0].SaveAs("export.xls");
    }
}

Imports IronXL

Friend Class Program
	Shared Sub Main()
		' Load an existing Excel file
		Dim workbook = WorkBook.Load("Demo file.xlsx")
		' Access the first sheet or the sheet by name
		Dim ws = workbook.GetWorkSheet("Sheet1")
		' Read a value from a cell and output it to the console
		Dim address_val As String = ws("A1").ToString()
		Console.WriteLine(address_val)
		' Modify a cell's value
		ws("A2").Value = "Hello World"
		' Save the workbook to different formats
		workbook.SaveAs("export.xlsx")
		workbook.SaveAs("export.xls")
		workbook.WorkSheets(0).SaveAs("export.xls")
	End Sub
End Class

Önceki örnek, dosya yolu ve adını argüman olarak alan Load fonksiyonu çağrılarak zaten mevcut olan bir Excel dosyasını yükler. Dosyayı WorkBook nesnesine içe aktarmak artık tamamlandı. Excel çalışma kitapları daha sonra, sayfa adını kullanarak çalışma sayfasını yüklememizi sağlayan GetWorkSheet yardımıyla yüklenir. Excel adresi daha sonra degeri okumak icin kullanildi. Excel dosyalarının nasıl okunacağı hakkında daha fazla bilgi icin buraya tıklayın.

Aynı Excel adresini kullanarak Excel sayfasının değerlerini değiştirebiliriz. Excel belgesi, WorkBook nesnesi tarafından sunulan SaveAs fonksiyonu kullanılarak XLSX veya XLS dosyası olarak kaydedilebilir. Bu süreç kullanılarak dosyanın tamamı seçilen formatta kaydedilir.

Ayrıca belirli bir Excel çalışma sayfasını indeks değerini kullanarak veya adını belirterek seçebiliriz. Bir sonraki adımda, SaveAs seçeneğini kullanarak Excel elektronik tablosundaki verileri farklı bir dosyaya aktarabiliriz. Daha fazla bilgi için Excel dosyalarını biçimlendirme ve dışa aktarma hakkında bilgi almak üzere bu bağlantıya tıklayın.

Sonuç

Excel için en popüler eklentilerden biri IronXL'dir. Herhangi bir ek dış kütüphaneye bağımlı değildir. Microsoft Excel'i yüklemek gerekli değildir çünkü kendi kendine yeten bir çözümdür. Birçok kanal üzerinden çalışır. Bu, Word belgelerini düzenlemek için ek kütüphaneler kullanarak dosyayı ayrıştırması gereken Interop kütüphanesi ile zıtlık gösterir.

Microsoft Excel belgeleri kullanan herhangi bir programlama süreci için tam bir çözüm IronXL'dir. Hesaplamalar, dizeleri veya sayıları sıralamak, kesme, ekleme, bulma ve değiştirme, birleştirme ve ayırma ve dosya depolama sadece mevcut işlemlerden birkaçıdır. Veri doğrulama özelliklerinin yanı sıra hücre verilerinin yeni biçimlerini de oluşturabilirsiniz. Dosyaları okumayı ve yazmayı ve Excel verilerini işlemeyi kolaylaştırır.

IronXL ilk piyasaya sürüldüğünde maliyeti $799 idi. Alternatif olarak, müşteriler bir yıllık abonelik ücreti ödemeyi ve yazılım güncellemeleri ve desteğini almayı tercih edebilirler. IronXL, izinsiz yeniden dağıtıma karşı koruma sağlar, ancak bunun için bir ücret alınır. IronXL lisanslama sayfasına gidin. Iron Software ürünleri hakkında daha fazla bilgi edinmek için buraya bakın.