Sorun Giderme Aspose.Words FOSS for .NET

Bu sayfa, Aspose.Words FOSS’ı .NET için oluştururken ve kullanırken karşılaşılan yaygın sorunları ve bunların nasıl çözüleceğini kapsar.

Derleme ve Kurulum Sorunları

dotnet add package Aspose.Words paketi bulamıyor

Bu komut, FOSS sürümü değil, ticari Aspose.Words paketine yönlendiriyor — FOSS paket kimliği Aspose.Words.FOSS:

dotnet add package Aspose.Words.FOSS

Alternatif olarak, kaynağı almak için git clone komutunu çalıştırın, ardından klonlanmış klasöre cd ve çözüme dotnet build komutunu çalıştırın:

git clone https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git
cd Aspose.Words-FOSS-for-.NET
dotnet build Aspose.Words.sln -c Release

Ardından paket referansı yerine kendi uygulamanızdan Aspose.Words.csproj‘a bir proje referansı ekleyin.

Proje referansı klonladıktan sonra çözümlenmiyor.

Referansın klonlanmış Aspose.Words-FOSS-for-.NET/Aspose.Words/ klasörünün içindeki Aspose.Words.csproj‘a işaret ettiğini ve çözümün önce (dotnet build Aspose.Words.sln -c Release) başarılı bir şekilde derlendiğini doğrulayın. Kütüphane .NET Standard 2.0’ı hedeflediğinden, .NET Framework 4.6.2+ veya .NET 6/8/10 hedefleyen herhangi bir SDK bunu referans alabilir.

Yükleme Sorunları

Belge yüklenirken UnsupportedFileFormatException

UnsupportedFileFormatException, dosya formatı tanınmadığında veya bu sürüm tarafından desteklenmediğinde yükleme sırasında fırlatılır. Bu sürümün yükleme formatları DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown ve düz metindir — input.doc gibi desteklenmeyen bir yolu Document yapıcısına geçirmek, yüklü bir belge döndürmek yerine bu istisnayı yükseltir:

using Aspose.Words;

try
{
    Document doc = new Document("input.doc");
}
catch (UnsupportedFileFormatException ex)
{
    Console.WriteLine("Format not supported by this edition: " + ex.Message);
}

Document yapıcısının etrafında UnsupportedFileFormatException‘ı yakalamak, istisnanın ham bir yığın izleme olarak yayılmasına izin vermek yerine net bir mesaj raporlamanızı sağlar.

Geçerli görünümlü bir dosyada FileCorruptedException

FileCorruptedException yükleme sırasında dosyanın bozuk göründüğü ve ayrıştırılamadığı zaman fırlatılır — örneğin, geçerli bir ZIP tabanlı OOXML paketi olmayan bir .docx dosyası veya aktarım sırasında kesilmiş bir dosya. Dosyayı kaynağından yeniden edinin ve Document ile yüklemeden önce doğru şekilde açıldığını doğrulayın.

IncorrectPasswordException korunan bir belge açılırken

Bir belge bir şifreyle şifrelendiğinde ve Document yapıcı metodunun LoadOptions aşırı yüklemesine sağlanan şifre eksik ya da hatalı olduğunda bu hata fırlatılır. Yüklemeden önce doğru şifreyi LoadOptions.Password aracılığıyla sağlayın.

Kaydetme ve Dışa Aktarım Sorunları

PDF, XPS veya görüntü uzantısına Document.Save() başarısız olur

Bu sürüm sayfa düzeni ve renderleme alt sistemini içermez, bu nedenle Document.Save() PDF, XPS veya görüntü formatlarına dışa aktaramaz.

Bunun yerine DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown veya düz metin olarak kaydedin — bunlar bu sürümün gerçekten yazdığı biçimlerdir. Ticari Aspose.Words for .NET PDF, XPS ve görüntü çıktısı ekler.

Sayfa numaraları ve içindekiler tablosu girişleri her zaman 0 gösterir

Aspose.Words .NET için FOSS tam bir alan değerlendirme motoru içerir, bu sayede DATE ve DOCPROPERTY gibi içerik alanları doğru şekilde güncellenir. Sayfa düzenine bağlı alanlar — sayfa numaraları, NUMPAGES, ve TOC girişleri — hesaplanmış bir değer yerine bir yer tutucu 0 ile değerlendirilir, çünkü bu sürüm belgeleri normalde sayfalara bölerek düzenleyen layout motorunu içermez. Bu, bu sürümde beklenen bir davranıştır, bir hata değildir.

Dijital İmza Sorunları

Bir belgeyi imzalamak hiçbir etki yapmaz

DigitalSignatureUtil.Sign() ve ilgili imzalama API’leri, ticari ürünle yapısal uyumluluk sağlamak amacıyla nesne modelinde bulunur, ancak bu FOSS sürümünde yeni bir imza oluşturmak işlevsel değildir — onları çağırmak imzalı bir çıktı üretmez. Bu sürüm, bir belgeye Document.DigitalSignatures ve DigitalSignatureUtil.LoadSignatures() aracılığıyla zaten eklenmiş imzaları inceleyebilir ve doğrulayabilir, ancak bir imzalama iş akışı .NET için ticari Aspose.Words gerektirir.

Yazı Tipi Sorunları

Gömülü yazı tipleri beklenenden daha büyük

EmbedTrueTypeFonts etkin olduğunda, yazı tipleri belgedeki yalnızca kullanılan gliflere göre alt kümelenmek yerine bütün dosyalar olarak gömülür, bu yüzden yazı tiplerini gömen kaydedilen dosyalar ticari ürünün eşdeğer çıktısından daha büyük olur. Bu sürümde bir çözüm yolu yoktur — gömülü yazı tipi alt kümelendirme dahil değildir.