Yükleme Seçeneklerini Belirtin

Bir belgeyi yüklerken bazı gelişmiş özellikleri ayarlayabilirsiniz. Aspose.Words size yükleme sürecinin daha hassas kontrolüne olanak tanıyan LoadOptions sınıfını sağlar. Bazı yükleme formatlarında, bu yükleme formatına yönelik yükleme seçeneklerini içeren karşılık gelen bir sınıf bulunur; örneğin, PDF formatına yüklemek için PdfLoadOptions veya TXT’ye yüklemek için TxtLoadOptions vardır. Bu makalede LoadOptions sınıfının seçenekleriyle çalışmaya ilişkin örnekler verilmektedir.

Görünümü Değiştirmek için Microsoft Word Sürümünü Ayarlayın

Microsoft Word uygulamasının farklı sürümleri belgeleri farklı şekilde görüntüleyebilir. Örneğin WPS Office kullanılarak üretilen DOCX veya DOTX gibi OOXML belgelerinde iyi bilinen bir sorun vardır. Böyle bir durumda, temel belge işaretleme öğeleri eksik olabilir veya farklı şekilde yorumlanabilir ve bu da Microsoft Word 2019’un böyle bir belgeyi Microsoft Word 2010’a göre farklı göstermesine neden olabilir.

Aspose.Words, varsayılan olarak belgeleri Microsoft Word 2019 kurallarını kullanarak açar. Belge yükleme işleminin önceki Microsoft Word uygulama sürümlerinden birinde olduğu gibi görünmesini sağlamanız gerekiyorsa, LoadOptions sınıfının MswVersion özelliğini kullanarak istenen sürümü açıkça belirtmelisiniz.

Aşağıdaki kod örneği, Microsoft Word sürümünün yükleme seçenekleriyle nasıl ayarlanacağını gösterir:

Görünümü Değiştirmek için Dil Tercihlerini Ayarlayın

Bir belgeyi Microsoft Word’te görüntülemenin ayrıntıları yalnızca uygulama sürümüne ve MswVersion özellik değerine değil aynı zamanda dil ayarlarına da bağlıdır. Microsoft Word, “Dosya → Seçenekler → Dil” bölümünde bulunabilen “Ofis Dil Tercihleri” iletişim kutusu ayarlarına bağlı olarak belgeleri farklı şekilde gösterebilir. Bu iletişim kutusunu kullanarak kullanıcı örneğin birincil dili, yazım denetleme dillerini, görüntüleme dillerini vb. seçebilir. Aspose.Words, LanguagePreferences özelliğini bu iletişim kutusunun eşdeğeri olarak sağlar. Aspose.Words çıktısı Microsoft Word çıktısından farklıysa EditingLanguage için uygun değeri ayarlayın; bu, çıktı belgesini iyileştirebilir.

Aşağıdaki kod örneği, Japonca’nın EditingLanguage olarak nasıl ayarlanacağını gösterir:

Belge Yüklerken Sorunları Kontrol Etmek İçin WarningCallback’i Kullanın

Bazı belgeler bozuk olabilir, geçersiz girişler içerebilir veya şu anda Aspose.Words tarafından desteklenmeyen özelliklere sahip olabilir. Bir belgeyi yüklerken oluşan sorunları öğrenmek istiyorsanız Aspose.Words, IWarningCallback arayüzünü sağlar.

Aşağıdaki kod örneği IWarningCallback arayüzünün uygulanmasını gösterir:

Yükleme süresi boyunca tüm sorunlar hakkında bilgi almak için WarningCallback özelliğini kullanın.

Aşağıdaki kod örneği bu özelliğin nasıl kullanılacağını gösterir:

Dış Kaynak Yüklemesini Kontrol Etmek için ResourceLoadingCallback’i kullanın

Bir belge, yerel diskte, ağda veya İnternet’te bir yerde bulunan görüntülere harici bağlantılar içerebilir. Aspose.Words bu tür görselleri otomatik olarak bir belgeye yükler ancak bu sürecin kontrol edilmesi gereken durumlar da vardır. Örneğin, belirli bir görseli gerçekten yüklememiz mi, yoksa onu atlamamız mı gerektiğine karar vermek için. ResourceLoadingCallback yükleme seçeneği bunu kontrol etmenizi sağlar.

Aşağıdaki kod örneği IResourceLoadingCallback arayüzünün uygulanmasını gösterir:

Aşağıdaki kod örneği ResourceLoadingCallback özelliğinin nasıl kullanılacağını gösterir:

Bellek İstisnasını Önlemek için TempFolder’ı Kullanın

Aspose.Words, zengin içerikle dolu binlerce sayfaya sahip son derece büyük belgeleri destekler. Bu tür belgelerin yüklenmesi çok fazla RAM gerektirebilir. Yükleme sürecinde, Aspose.Words’in bir belgeyi ayrıştırmak için kullanılan geçici yapıları tutmak için daha da fazla belleğe ihtiyacı vardır.

Belge yüklerken Bellek Yetersizliği istisnasıyla ilgili bir sorunla karşılaşırsanız TempFolder özelliğini kullanmayı deneyin. Bu durumda Aspose.Words, bazı verileri bellek yerine geçici dosyalarda saklar ve bu, böyle bir istisnanın önlenmesine yardımcı olabilir.

Aşağıdaki kod örneği TempFolder‘in nasıl ayarlanacağını gösterir:

Kodlamayı Açıkça Ayarlayın

Çoğu modern belge formatı, içeriklerini Unicode’da saklar ve özel bir işlem gerektirmez. Öte yandan, Unicode öncesi bazı kodlamaları kullanan ve bazen kodlama bilgilerini kaçıran veya doğası gereği kodlama bilgilerini bile desteklemeyen birçok belge hala vardır. Aspose.Words, varsayılan olarak uygun kodlamayı otomatik olarak algılamaya çalışır, ancak nadir bir durumda, kodlama tanıma algoritmamız tarafından algılanandan farklı bir kodlama kullanmanız gerekebilir. Bu durumda kodlamayı almak veya ayarlamak için Encoding özelliğini kullanın.

Aşağıdaki kod örneği, kodlamanın otomatik olarak seçilen kodlamayı geçersiz kılacak şekilde nasıl ayarlanacağını gösterir:

Şifreli Belgeleri Yükle

Bir parola ile şifrelenmiş Word belgelerini yükleyebilirsiniz. Bunu yapmak için LoadOptions nesnesini kabul eden özel bir yapıcı aşırı yüklemesi kullanın. Bu nesne, parola dizesini belirten Password özelliğini içerir.

Aşağıdaki kod örneği, parolayla şifrelenmiş bir belgenin nasıl yükleneceğini gösterir:

Dosyanın şifrelenip şifrelenmediğini önceden bilmiyorsanız, dosya formatlarıyla çalışmak için dosya formatını algılama veya dosya uzantılarını dosya formatı numaralandırmalarına/dosya uzantılarından dönüştürme gibi yardımcı yöntemler sağlayan FileFormatUtil sınıfını kullanabilirsiniz. Belgenin şifrelenip şifrelenmediğini ve onu açmak için parola gerekip gerekmediğini tespit etmek için IsEncrypted özelliğini kullanın.

Aşağıdaki kod örneği, OpenDocument’in şifrelenmiş olup olmadığının nasıl doğrulanacağını gösterir: