Word Belgelerini .NET içinde Dışa Aktarma ve Kaydetme
Bu kılavuz, Aspose.Words FOSS kullanarak .NET için bir Word belgesini nasıl dışa aktaracağınızı ve kaydedeceğinizi gösterir: türetilen veya açık bir formatla kaydetme, OOXML kaydetme seçeneklerini yapılandırma, Markdown’a dışa aktarma, düz metne dışa aktarma ve dönüştürmeden önce bir dosyanın formatını tespit etme. Aspose.Words FOSS, .NET için NuGet üzerinden veya kaynak koddan derlenerek temin edilebilir.
Adım Adım Kılavuz
Adım 1: Kütüphaneyi Edinin
Depoyu klonlayın ve derleyin Aspose.Words.sln Release yapılandırmasında, ardından bir proje referansı ekleyin Aspose.Words.csproj kendi .NET projenizden, şu şekilde açıklanmıştır Kurulum kılavuzunda. Ekle using Aspose.Words; belge kaydeden herhangi bir dosyanın en üstüne.
Adım 2: Türetilen veya Açık Bir Formatla Kaydet
Document.Save(fileName), hedef formatı dosyanın uzantısından çıkarır. Save(fileName, saveFormat), uzantıya bakılmaksızın bir SaveFormat enum değeri alarak formatı açıkça belirler ve Save(fileName, saveOptions) (veya eşleşen Stream aşırı yüklemeleri) format-özel kontrol için bir SaveOptions alt sınıfını alır. SaveOptions.CreateSaveOptions(saveFormat), belirli bir SaveFormat için varsayılanları önceden ayarlanmış eşleşen seçenekler alt sınıfını döndüren statik bir fabrikadır. Bu sürüm, DOCX, DOCM, DOTX, DOTM ve Flat OPC (makro-etkin ve şablon çeşitleri dahil) ile Markdown ve düz metin arasında tam olarak hem dışa hem de içe kaydetme sağlar.
Adım 3: OOXML Dışa Aktarma Seçeneklerini Yapılandır
OoxmlSaveOptions, Open XML varyantlarından herhangi birine kaydetmeyi yapılandırır. SaveFormat özelliği, özellikle DOCX, DOCM, DOTX, DOTM veya Flat OPC’yi seçer; Password, kaydedilen dosyaya, Document.Protect‘ün düzenleme kısıtlamasından bağımsız olarak bir açık şifre ayarlar; Compliance, OOXML katılık seviyesini seçer; ve CompressionLevel / Zip64Mode, temel ZIP paketlemesini kontrol eder. new OoxmlSaveOptions(saveFormat) ile ya da SaveOptions.CreateSaveOptions(saveFormat) aracılığıyla bir tane oluşturun.
Adım 4: Markdown’a Dışa Aktar
MarkdownSaveOptions, bir Markdown dışa aktarmayı kontrol eder: ListExportMode ve LinkExportMode, listelerin ve köprülerin nasıl render edildiğini yönetir, ImagesFolder / ImagesFolderAlias, çıkarılan görüntülerin nereye gideceğini ve nasıl referans verileceğini kontrol eder, ExportImagesAsBase64, ayrı dosyalar yazmak yerine bunları satır içi gömer ve TableContentAlignment, oluşturulan tablo işaretlemesini etkiler. Bir MarkdownSaveOptions örneğini Document.Save(fileName, saveOptions)‘a .md dosya adıyla geçirin veya SaveFormat‘u açıkça ayarlayın.
Adım 5: Düz Metne Dışa Aktar
TxtSaveOptions (paylaşılan tabanı TxtSaveOptionsBase aracılığıyla, aynı zamanda MarkdownSaveOptions tarafından da kullanılır) düz metin dışa aktarmayı kontrol eder: Encoding karakter kodlamasını ayarlar, ParagraphBreak satır sonu dizgisini ayarlar, MaxCharactersPerLine uzun satırları kaydırır, SimplifyListLabels liste işaretlerini ve numaraları düz karakterlere normalleştirir ve PreserveTableLayout tablo sütunlarını boşluklarla hizalı tutar.
Adım 6: Dönüştürmeden Önce Bir Biçimi Algıla
Bilinmeyen bir biçimdeki dosyayı dönüştürmeden önce, FileFormatUtil.DetectFileFormat(fileName) tespit edilen LoadFormat ile bir FileFormatInfo döndürür. FileFormatUtil.LoadFormatToSaveFormat(loadFormat) ile eşleştirerek bu biçimin, Document.Save‘ı çağırmadan önce bu sürümün desteklediği biçimler aracılığıyla çift yönlü (round-trip) geçip geçemeyeceğini kontrol edin. Bazı SaveFormat enum üyeleri API bütünlüğü için mevcuttur ancak bu sınırlı, açık kaynak sürüm, bu adlandırılmış biçimler için çalışan bir okuyucu veya yazar uygulamaz; güvenilir çıktı için DOCX/DOCM/DOTX/DOTM/Flat OPC ailesi ile Markdown ve düz metni kullanın.
Yaygın Sorunlar ve Çözümler
Save(fileName) yanlış formatı yazar. Dosya uzantısı hedeflenen formatla eşleşmiyor. Kullan Save(fileName, saveFormat) or Save(fileName, saveOptions) formatı uzantıya güvenmek yerine açıkça belirtmek için.
Kaydedilen OOXML dosyası şifreyle açılamaz. OoxmlSaveOptions.Password kaydetmeden önce ayarlanmamıştı. Birini oluşturun OoxmlSaveOptions, ayarla Password, ve ona geçir Save.
Markdown dışa aktarımı görüntü dosyalarını beklenmedik şekilde dağıtır. Default MarkdownSaveOptions davranış görüntüleri ayrı dosyalara çıkarır. Ayarla ExportImagesAsBase64 = true for tek bir bütünleşik Markdown dosyası için, ya da ayarla ImagesFolder görsellerin nereye yerleştirileceğini kontrol etmek için.
Düz metin dışa aktarımı tablo sütun hizalamasını kaybeder. TxtSaveOptions.PreserveTableLayout varsayılan olarak bırakılır. Ayarlayın PreserveTableLayout = true kaydetmeden önce.
Sık Sorulan Sorular
Dosya uzantısına bakılmaksızın belirli bir formata nasıl kaydederim?
Açık bir SaveFormat değeriyle Save(fileName, saveFormat) çağırın, ya da eşleşen bir SaveOptions alt sınıfıyla Save(fileName, saveOptions).
Bu sürümde iki yönlü round-trip yapabilen formatlar hangileridir?
DOCX, DOCM, DOTX, DOTM, Düz OPC (makro-etkin ve şablon varyantları dahil), Markdown ve düz metin.
Kaydedilen bir dosyayı, açılması bile mümkün olmayacak şekilde şifreyle nasıl korurum?
OoxmlSaveOptions örneği üzerinde Password ayarlayın ve Document.Save(fileName, saveOptions)‘ye geçirin.
Dışa aktarılan bir metin dosyasında satır sonlarını nasıl kontrol ederim?
Kaydetmeden önce bir TxtSaveOptions örneği üzerinde ParagraphBreak ayarlayın.
Bir dosyanın formatını dönüştürmeden önce nasıl kontrol ederim?
Çağır FileFormatUtil.DetectFileFormat(fileName) ve döndürülen FileFormatInfo.LoadFormat‘i oku.
