DOCX Düzenleme ve Format Dönüştürme GroupDocs.Editor ile Nasıl Yapılır

Effortlessly manage and transform Word documents within your .NET environment using GroupDocs.Editor .NET. In this tutorial you’ll discover how to edit docx files, convert them to formats such as RTF, DOCM, and plain text, and automate your document workflow for maximum productivity.

Hızlı Yanıtlar

  • Gerekli kütüphane nedir? GroupDocs.Editor for .NET (20.10+).
  • DOCX’i RTF’ye dönüştürebilir miyim? Evet – WordProcessingSaveOptions ile WordProcessingFormats.Rtf kullanın.
  • TXT olarak kaydetme destekleniyor mu? Kesinlikle, TextSaveOptions aracılığıyla.
  • Lisans gerekli mi? Geliştirme için bir deneme sürümü çalışır; bir lisans tüm özelliklerin kilidini açar.
  • Birçok dosyayla nasıl başa çıkılır? Kodu async/await veya Parallel.ForEach ile birleştirerek toplu işleme yapabilirsiniz.

GroupDocs.Editor ile “docx nasıl düzenlenir” nedir?

GroupDocs.Editor bir DOCX dosyasını yükler, içeriğini düzenlenebilir HTML olarak sunar, bu HTML’i programlı olarak değiştirmenize olanak tanır ve ardından sonucu herhangi bir desteklenen formata kaydeder. Bu yaklaşım Office interop ihtiyacını ortadan kaldırır ve herhangi bir sunucu‑tarafı .NET platformunda çalışır.

Belge iş akışı otomasyonu için GroupDocs.Editor neden kullanılmalı?

  • Sadece sunucu‑tarafı – Office kurulumu gerekmez.
  • Birden çok çıktı formatı – RTF, DOCM, TXT, HTML, PDF vb.
  • Yüksek performans – toplu senaryolar için tasarlanmış hafif API.
  • Tam kontrol – kaydetmeden önce HTML parçacıklarını düzenleyin, değiştirin veya ekleyin.

Önkoşullar

  • GroupDocs.Editor kütüphanesi (Versiyon 20.10 veya üzeri)
  • .NET Framework 4.7.2 + veya .NET 5/6
  • Visual Studio (herhangi bir yeni sürüm)
  • Temel C# bilgisi ve dosya I/O konusunda aşinalık

GroupDocs.Editor Kurulumu

Paketi .NET CLI, Package Manager Console veya NuGet UI aracılığıyla ekleyebilirsiniz.

dotnet add package GroupDocs.Editor
Install-Package GroupDocs.Editor

Lisans Edinimi

Ücretsiz deneme ile başlayın veya geçici bir lisans anahtarı isteyin. Üretim ortamı için, sınırsız işleme erişmek amacıyla bir lisans satın alın.

DOCX Belgesini Yükleme ve Düzenleme

İlk olarak, editörü kaynak dosyanıza yönlendirin, ardından düzenlenebilir HTML’i alın, ihtiyacınız olan değişiklikleri yapın ve son olarak değiştirilmiş işaretlemeden yeni bir EditableDocument oluşturun.

using (Editor editor = new Editor("YOUR_DOCUMENT_DIRECTORY/sample.docx", new Options.WordProcessingLoadOptions()))
{
    // Your document manipulation code here
}

Adım‑Adım Kod İncelemesi

  1. Giriş dosya yolunu tanımlayın
string inputFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.docx";
  1. Editor örneğini oluşturun
using GroupDocs.Editor;
using GroupDocs.Editor.Options;

Editor editor = new Editor(inputFilePath, new Options.WordProcessingLoadOptions());
  1. Belgenin HTML’ini düzenleyin
EditableDocument defaultWordProcessingDoc = editor.Edit();
string allEmbeddedInsideString = defaultWordProcessingDoc.GetEmbeddedHtml();
string allEmbeddedInsideStringEdited = allEmbeddedInsideString.Replace("Subtitle", "Edited subtitle");
  1. Düzenlenmiş HTML’den yeni bir EditableDocument oluşturun
EditableDocument editedDoc = EditableDocument.FromMarkup(allEmbeddedInsideStringEdited, null);
  1. Geçici nesneleri serbest bırakın
editedDoc.Dispose();
defaultWordProcessingDoc.Dispose();
editor.Dispose();

Word’ü RTF’ye Dönüştürme

Düzenlenmiş belgeyi RTF olarak kaydetmek, uygun kaydetme seçenekleriyle oldukça basittir.

string outputRtfPath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "editedDoc.rtf");
WordProcessingSaveOptions rtfSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Rtf);
using (Editor editor = new Editor(inputFilePath, new Options.WordProcessingLoadOptions()))
{
    editor.Save(editedDoc, outputRtfPath, rtfSaveOptions);
}
editor.Dispose();

DOCX’i Stream Kullanarak DOCM Olarak Kaydetme

Makro‑destekli DOCM formatına ihtiyacınız olduğunda, doğrudan bir FileStream‘e yazabilirsiniz.

string outputDocmPath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "editedDoc.docm");
WordProcessingSaveOptions docmSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docm);
using (Editor editor = new Editor(inputFilePath, new Options.WordProcessingLoadOptions()))
{
    using (FileStream outputStream = File.Create(outputDocmPath))
    {
        editor.Save(editedDoc, outputStream, docmSaveOptions);
    }
}
editor.Dispose();

DOCX’i TXT’ye (Düz Metin) Dönüştürme

Düz metin çıkarımı, indeksleme, arama veya e‑posta bildirimleri için faydalıdır.

string outputTxtPath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "editedDoc.txt");
TextSaveOptions textSaveOptions = new TextSaveOptions()
{
    Encoding = Encoding.UTF8,
    PreserveTableLayout = true
};
using (Editor editor = new Editor(inputFilePath, new Options.WordProcessingLoadOptions()))
{
    editor.Save(editedDoc, outputTxtPath, textSaveOptions);
}
editor.Dispose();

Yaygın Kullanım Durumları ve Gerçek Dünya Senaryoları

  • Otomatik Rapor Oluşturma: Analitik Word raporlarını e‑posta dağıtımı için TXT’ye dönüştürün.
  • Ortak Düzenleme Platformları: Kullanıcıların HTML parçacıklarını düzenlemesine izin verin ve sonucu DOCM veya RTF olarak saklayın.
  • Belge Arşivleme: İçeriği koruyarak eski DOCX dosyalarını makro desteği için DOCM’ye taşıyın.
  • Web Servisleri: Geçici dosyalar olmadan anlık DOCX → PDF/RTF dönüşümleri akıtın.

Word Belgelerini Toplu İşleme İçin Performans İpuçları

  • Hemen serbest bırakın: Editor ve belge nesnelerinde her zaman Dispose() çağırın.
  • Akıllıca yükleyin: Gereksiz ayrıştırmayı önlemek için en spesifik LoadOptions‘ı seçin.
  • Güvenli paralelleştirme: Her iş parçacığı için ayrı Editor örnekleriyle Parallel.ForEach kullanın.
  • Büyük bellek içi dizgilerden kaçının: Büyük belgeleri işlerken tam HTML dizgileri yerine akışlarla çalışın.

Sıkça Sorulan Sorular

S: Parola korumalı bir DOCX’i düzenleyebilir miyim?
C: Evet. Editor oluştururken WordProcessingLoadOptions.Password aracılığıyla parolayı sağlayın.

S: Tek bir çalıştırmada birden çok dosyayı dönüştürmek mümkün mü?
C: Kesinlikle. Tek dosya mantığını bir döngüye sarın veya eşzamanlı işleme için Parallel.ForEach kullanın.

S: GroupDocs.Editor .NET Core’u destekliyor mu?
C: Kütüphane .NET 5, .NET 6 ve .NET Core 3.1’in yanı sıra tam .NET Framework ile de çalışır.

S: DOCM olarak kaydettiğimde makrolar ne olur?
C: Docm kaydetme formatını kullandığınızda makrolar korunur; RTF/TXT için ise kaldırılır.

S: Büyük toplu işler sırasında “OutOfMemoryException” hatasını nasıl gideririm?
C: Dosyaları daha küçük partilerde işleyin, nesneleri hemen serbest bırakın ve uygulamanın bellek limitini artırmayı düşünün.

Sonuç

Artık GroupDocs.Editor .NET kullanarak docx nasıl düzenlenir dosyalarını RTF, DOCM veya düz metin olarak dönüştürmek için eksiksiz, üretim‑hazır bir iş akışına sahipsiniz. Yukarıdaki adımları izleyerek belge iş akışlarını otomatikleştirebilir, toplu işleme yapabilir ve herhangi bir .NET uygulamasına sorunsuz format dönüşümünü entegre edebilirsiniz.


Last Updated: 2026-04-07
Tested With: GroupDocs.Editor 20.10 (latest at time of writing)
Author: GroupDocs