C# ile MS Word Belgeleri oluşturma

C# ile MS Word Belgeleri oluşturma

Belgeleri programlı olarak oluşturmak ve düzenlemek için Microsoft [Word] otomasyonu artık zor bir iş olmayabilir. Mevcut MS dosyalarını C#’ta birkaç satır kaynak kodu kullanarak değiştirmek, iş yazılımınızda size rekabet avantajı sağlayabilir. Ancak bu blog yazısında C#’ta MS Word Belgelerinin nasıl oluşturulacağını öğreneceğiz. Bu .NET kütüphane, Word otomasyonuyla ilgili çeşitli görevleri gerçekleştirmek için çok çeşitli yöntemler ve özellikler sunar.

Bu eğitimde aşağıdaki noktalar ele alınacaktır:

C#’ta MS Word Belgeleri oluşturma - API kurulumu

Bu .Net API’sini iki şekilde yükleyebilirsiniz.

.NET uygulamanızda bu kitaplığı etkinleştirmek için DLL dosyalarını İndir.

Veya NuGet paket yöneticisinde aşağıdaki komutu çalıştırarak yükleyebilirsiniz.

Install-Package Aspose.Words

Programlı olarak bir Word belgesi nasıl oluşturulur?

.NET Word otomasyon API’sinin başarılı kurulumundan sonra, ilk MS Word belgemizi programlı olarak oluşturmak için C# dilinde kod yazmaya hazırız.

C#’ta Word Belgesi oluşturmak için aşağıdaki adımları ve kod parçasını takip edebilirsiniz.

  1. Boş bir MS Word dosyası oluşturmak için Document sınıfının bir nesnesini oluşturun.
  2. DocumentBuilder sınıfının bir örneğini başlatın ve onu yeni bir Document nesnesine ekleyin.
  3. Belgeye bir dize eklemek için Write yöntemini çağırın.
  4. MS Word dosyasını kaydetmek için save yöntemini çağırın.
// Boş bir MS Word dosyası oluşturmak için Document sınıfının bir nesnesini oluşturun. 
Document doc = new Document();    
// DocumentBuilder sınıfının bir örneğini başlatın ve bunu yeni bir Document nesnesine ekleyin 
DocumentBuilder builder = new DocumentBuilder(doc);
// Belgeye bir dize eklemek için Write yöntemini çağırın 
builder.Write("this is start of the page ");
// MS Word dosyasını kaydetmek için kaydetme yöntemini çağırın
doc.Save("./output.docx");

C# kullanarak Word dosyasına paragraflar ekleme

Bu bölümde, bir MS Word belgesine programlı olarak nasıl paragraf ekleneceğini öğreneceğiz.

Aşağıdaki adımlar ve kod pasajı takip edilebilir:

  1. Boş bir MS Word dosyası oluşturmak için Document sınıfının bir nesnesini örnekleyin.
  2. DocumentBuilder sınıfının bir örneğini oluşturun ve bunu yeni bir Document nesnesine ekleyin.
  3. Belgeye paragraf sonu eklemek için Writeln yöntemini çağırın.
  4. Writeln(string) yöntemi bir paragraf ekler.
  5. save yöntemi MS Word dosyasını kaydedecektir.
// Boş bir MS Word dosyası oluşturmak için Document sınıfının bir nesnesini oluşturun. 
Document doc = new Document();    
// DocumentBuilder sınıfının bir örneğini oluşturun ve bunu yeni bir Document nesnesine ekleyin 
DocumentBuilder builder = new DocumentBuilder(doc);
// belgeye paragraf sonu eklemek için Writeln'i arayın.
builder.Writeln();
// Writeln(string) yöntemi bir paragraf ekler.
builder.Writeln("this is the first paragraph");
builder.Writeln();
builder.Writeln("this is the second paragraph");
builder.Writeln();
// kaydetme yöntemi MS Word dosyasını kaydedecektir
doc.Save("./output.docx");

C#’ta MS Word dosyasına tablo nasıl eklenir

C# kullanarak bir Word belgesine tablo eklemek için adımları ve kod pasajını izleyin:

  1. Boş bir MS Word dosyası oluşturmak için Document sınıfının bir örneğini başlatın.
  2. DocumentBuilder sınıfının bir örneğini oluşturun ve bunu yeni bir Document nesnesine ekleyin.
  3. MS Word dosyasına bir tablo eklemek için StartTable yöntemini çağırın.
  4. InsertCell yöntemi bir tablo hücresi ekleyecektir.
  5. EndRow yöntemi tablonun bir satırını sonlandırır.
  6. Tabloyu sonlandırmak için EndTable yöntemini çağırın.
  7. MS Word dosyasını kaydetmek için save yöntemini kullanın.
 // MS Word dosyasına tablo eklemek için StartTable yöntemini çağırın.
builder.StartTable();
 // InsertCell bir tablo hücresi ekleyecektir  
builder.InsertCell();
builder.Write("Row 1, Cell 1.");
builder.InsertCell();
builder.Write("Row 1, Cell 2.");
// EndRow yöntemi bir tablonun satırını sonlandırır 
builder.EndRow();
builder.InsertCell();
builder.Write("Row 2, Cell 1.");
builder.InsertCell();
builder.Write("Row 2, Cell 2.");
builder.EndRow();
// Tabloyu sonlandırmak için EndTable yöntemini çağırın.
builder.EndTable();
// MS Word dosyasını kaydetmek için kaydetme yöntemini çağırın
doc.Save("./output.docx");

Word belgesine programlı olarak liste ekleme

Liste herhangi bir belgenin ayrılmaz bir parçasıdır. Ancak C# dilindeki bir Word belgesine liste bileşenini aşağıda belirtilen adımları ve kod parçacığını takip ederek ekleyebilirsiniz:

  1. Boş bir MS Word dosyası oluşturmak için Document sınıfının bir nesnesini oluşturun.
  2. DocumentBuilder sınıfının bir örneğini oluşturun ve onu yeni bir Document nesnesine ekleyin.
  3. Geçerli liste biçimlendirme özelliklerini temsil eden bir nesneyi döndüren ListFormat özelliğini çağırın ve ApplyBulletDefault yöntemi, her paragraftan önce bir girinti ve madde işareti simgesi ("•") uygulayacaktır.
  4. MS Word dosyasını kaydetmek için save yöntemini çağırın.
 // MS Word dosyasına tablo eklemek için StartTable yöntemini çağırın.
builder.StartTable();
 // InsertCell bir tablo hücresi ekleyecektir  
builder.InsertCell();
builder.Write("Row 1, Cell 1.");
builder.InsertCell();
builder.Write("Row 1, Cell 2.");
// EndRow yöntemi bir tablonun satırını sonlandırır 
builder.EndRow();
builder.InsertCell();
builder.Write("Row 2, Cell 1.");
builder.InsertCell();
builder.Write("Row 2, Cell 2.");
builder.EndRow();
// Tabloyu sonlandırmak için EndTable yöntemini çağırın.
builder.EndTable();
// MS Word dosyasını kaydetmek için kaydetme yöntemini çağırın
doc.Save("./output.docx");

.NET uygulamalarında Word belgesinin Yazı Tipleri nasıl düzenlenir?

Şimdi, C# kodunu kullanarak bir MS Word belgesindeki yazı tiplerini programlı olarak ekleyeceğiz ve düzenleyeceğiz.

Aşağıdaki adımları ve kod pasajını izleyin:

  1. Boş bir MS Word dosyası oluşturmak için Document sınıfının bir nesnesini oluşturun.
  2. DocumentBuilder sınıfının bir örneğini başlatın ve onu yeni bir Document nesnesine ekleyin.
  3. Font sınıfı, bir Word belgesinin yazı tipine stil vermek için çeşitli özellikler sunar.
  4. LineWidth özelliği kenarlık genişliğini nokta cinsinden ayarlar.
  5. LineStyle bir kenarlığın çizgi stilini belirtir.
  6. Yazı tipinin boyutunu ayarlamak için Size özelliğini çağırın.
  7. Name özelliği yazı tipinin adını ayarlamak için kullanılır.
  8. Bold özelliğini çağırarak metninizi kalın yapın.
  9. MS Word dosyasını kaydetmek için save yöntemini çağırın.
// LineWidth özelliği kenarlık genişliğini nokta cinsinden belirler. 
builder.Font.Border.LineWidth = 0.5d;
// LineStyle, Kenarlığın çizgi stilini belirtir. 
builder.Font.Border.LineStyle = LineStyle.DashDotStroker;
// Yazı tipinin boyutunu ayarlamak için Size özelliğini çağırın. 
builder.Font.Size = 16;
// Fontun adını ayarlamak için Name özelliği kullanılır. 
builder.Font.Name = "Arial";
// Kalın özelliğini çağırarak metninizi kalın yapın 
builder.Font.Bold = true;
builder.Write("Text surrounded by border.");
builder.Writeln();
// MS Word dosyasını kaydetmek için kaydetme yöntemini çağırın
doc.Save("./output.docx");

Ücretsiz Lisans Alın

API’yi değerlendirme sınırlamaları olmaksızın denemek için ücretsiz geçici lisans alabilirsiniz.

Özetliyor

Yukarıdaki kod parçacıklarının tamamı tek bir C# dosyasında çalıştırıldığında aşağıdaki çıktı.docx oluşturulacaktır.

C# ile MS Word Belgeleri oluşturma

Bu bizi bu blog yazısının sonuna getiriyor. C#’ta programlı olarak MS Word belgelerinin nasıl oluşturulacağını gösterdik. Ayrıca bir MS Word dosyasına Tablolar, Listeler, Paragraflar ve Yazı Tipleri gibi çeşitli bileşenlerin nasıl ekleneceğini de araştırdık. Ayrıca bu .NET API’nin dokümantasyonunu ziyaret ederek diğer yöntemleri inceleyebilirsiniz. Gelecek blog yazılarımızda başka faydalı konulara da değineceğiz. Bu nedenle güncellemeler için conholdate.com ile iletişim halinde kalın.

Bir soru sor

Sorularınızı veya sorularınızı forumumuz üzerinden bize bildirebilirsiniz.

Ayrıca bakınız