Zadejte možnosti zatížení
Při načítání dokumentu můžete nastavit některé pokročilé vlastnosti. Aspose.Words poskytuje vám LoadOptions třída, která umožňuje přesnější řízení procesu zatížení. Některé formáty zatížení mají odpovídající třídu, která drží možnosti zatížení pro tento formát zatížení, například PdfLoadOptions pro načtení do formátu PDF nebo TxtLoadOptions pro načtení do TXT. Tento článek uvádí příklady práce s možnostmi LoadOptions třída.
Nastavit Microsoft Word Verze pro změnu vzhledu
Různé verze Microsoft Word aplikace může zobrazovat dokumenty jinak. Například existuje známý problém s OOXML dokumenty, jako je DOCX nebo DOTX vyrobené pomocí WPS Office. V takovém případě mohou být základní prvky značení dokumentů chybějící nebo mohou být vykládány jinak, což způsobuje Microsoft Word 2019 ukázat takový dokument jinak než Microsoft Word 2010.
Výchozí Aspose.Words otevírá dokumenty pomocí Microsoft Word 2019 pravidla. Pokud potřebujete načíst dokument, zdá se, že by se to stalo v jednom z předchozích případů Microsoft Word Aplikace verze, měli byste výslovně zadat požadovanou verzi pomocí MswVersion majetek LoadOptions třída.
Následující příklad kódu ukazuje, jak nastavit Microsoft Word verze s možností zatížení:
Nastavit předvolby jazyka ke změně vzhledu
Údaje o zobrazení dokumentu v Microsoft Word závisí nejen na verzi aplikace a MswVersion hodnota vlastnosti, ale také nastavení jazyka. Microsoft Word může zobrazit dokumenty jinak v závislosti na dialogovém okně “Office Language Preferences,” které lze nalézt v “File → Options → Languаge.” Pomocí tohoto dialogu si uživatel může vybrat například primární jazyk, dokládající jazyky, zobrazovat jazyky a tak dále. Aspose.Words poskytuje LanguagePreferences vlastnost jako ekvivalent tohoto dialogu. Pokud Aspose.Words výstup se liší od Microsoft Word výstup, nastavit vhodnou hodnotu pro EditingLanguage To může zlepšit výstupní dokument.
Následující příklad kódu ukazuje, jak nastavit japonsky jako EditingLanguage:
Použití WarningCallback na kontrolu problémů Při načítání dokumentu
Některé dokumenty mohou být poškozeny, obsahují neplatné položky nebo mají funkce, které nejsou v současné době podporovány Aspose.Words. Pokud chcete vědět o problémech, které nastaly při načítání dokumentu, Aspose.Words poskytuje IWarningCallback rozhraní.
Následující příklad kódu ukazuje provádění IWarningCallback rozhraní:
Chcete- li získat informace o všech problémech po celou dobu zatížení, použijte WarningCallback majetek.
Následující příklad kódu ukazuje, jak používat tuto vlastnost:
Použít vyhledávání zdrojů Zpětná vazba k ovládání zatížení externích zdrojů
Dokument může obsahovat externí odkazy na obrázky umístěné někde na místním disku, síti nebo internetu. Aspose.Words automaticky tyto obrázky naloží do dokumentu, ale existují situace, kdy je třeba tento proces kontrolovat. Například rozhodnout, zda opravdu potřebujeme načíst určitý obraz nebo jej možná přeskočit. • ResourceLoadingCallback možnost načíst umožňuje ovládat.
Následující příklad kódu ukazuje provádění IResourceLoadingCallback rozhraní:
Následující příklad kódu ukazuje, jak používat ResourceLoadingCallback vlastnost:
Pomocí TempFolder vyhnout paměti výjimky
Aspose.Words podporuje mimořádně velké dokumenty, které mají tisíce stránek plných bohatého obsahu. Načítání těchto dokumentů může vyžadovat mnoho RAM. Během nakládky Aspose.Words potřebuje ještě více paměti k udržení dočasných struktur používaných k analýze dokumentu.
Pokud máte problém s výjimkou mimo paměť při načítání dokumentu, zkuste použít TempFolder majetek. V tomto případě Aspose.Words uloží některé údaje do dočasných souborů namísto paměti, a to může pomoci vyhnout se této výjimky.
Následující příklad kódu ukazuje, jak nastavit TempFolder:
Nastavit kódování Explicitně
Většina moderních formátů dokumentů ukládá svůj obsah v Unicode a nevyžaduje zvláštní zacházení. Na druhé straně je stále mnoho dokumentů, které používají nějaké kódování před Unicode a někdy buď vynechá informace o kódování, nebo dokonce nepodpoří kódování podle povahy. Aspose.Words se snaží automaticky detekovat odpovídající kódování ve výchozím nastavení, ale ve vzácných případech budete muset použít kódování odlišné od toho, které detekuje náš kódovací algoritmus. V tomto případě použijte Encoding vlastnost získat nebo nastavit kódování.
Následující příklad kódu ukazuje, jak nastavit kódování k potlačení automaticky zvoleného kódování:
Načíst zašifrované dokumenty
Můžete nabíjet Slovní dokumenty zašifrované heslem. K tomu použijte speciální konstruktor přetížení, které přijímá LoadOptions objekt. Tento objekt obsahuje Password vlastnost, která určuje řetězec hesla.
Následující příklad kódu ukazuje, jak načíst dokument zašifrovaný heslem:
Pokud nevíte předem, zda je soubor zašifrován, můžete použít FileFormatUtil třída, která poskytuje užitné metody pro práci s formáty souborů, jako je zjištění formátu souboru nebo převod přípony souboru do/z čísel formátu souboru. Chcete-li zjistit, zda je dokument zašifrovaný a vyžaduje heslo k jeho otevření, použijte IsEncrypted majetek.
Následující příklad kódu ukazuje, jak ověřit OpenDocument buď je zašifrovaný, nebo ne: