Jak exportovat a uložit dokumenty Word v .NET
Tento návod ukazuje, jak exportovat a uložit dokument Word pomocí Aspose.Words FOSS pro .NET: ukládání s odhadovaným nebo explicitním formátem, konfiguraci možností uložení OOXML, export do Markdownu, export do prostého textu a detekci formátu souboru před jeho konverzí. Aspose.Words FOSS pro .NET je k dispozici prostřednictvím NuGet nebo sestavením ze zdrojového kódu.
Průvodce krok za krokem
Krok 1: Získat knihovnu
Naklonujte repozitář a sestavte Aspose.Words.sln v konfiguraci Release, poté přidejte referenci na projekt do Aspose.Words.csproj z vašeho vlastního projektu .NET, jak je popsáno v Instalační příručce. Přidejte using Aspose.Words; na začátek libovolného souboru, který ukládá dokumenty.
Krok 2: Uložit s odhadovaným nebo explicitním formátem
Document.Save(fileName) odhaduje cílový formát z přípony souboru. Save(fileName, saveFormat) dělá formát explicitním bez ohledu na příponu tím, že přijímá výčtovou hodnotu SaveFormat, a Save(fileName, saveOptions) (nebo odpovídající přetížení Stream) přijímá podtřídu SaveOptions pro formátově specifickou kontrolu. SaveOptions.CreateSaveOptions(saveFormat) je statická továrna, která vrací odpovídající podtřídu možností s přednastavenými výchozími hodnotami pro daný SaveFormat. Toto vydání plně ukládá jak do, tak z DOCX, DOCM, DOTX, DOTM a Flat OPC (plus jejich varianty s makry a šablonami), stejně jako do Markdownu a prostého textu.
Krok 3: Nakonfigurujte možnosti exportu OOXML
OoxmlSaveOptions konfiguruje ukládání do libovolné z variant Open XML. Jeho vlastnost SaveFormat vybírá konkrétně DOCX, DOCM, DOTX, DOTM nebo Flat OPC; Password nastaví otevřené heslo na uložený soubor, nezávisle na omezení úprav Document.Protect; Compliance vybírá úroveň přísnosti OOXML; a CompressionLevel / Zip64Mode řídí podkladové balení ZIP. Vytvořte jej pomocí new OoxmlSaveOptions(saveFormat) nebo přes SaveOptions.CreateSaveOptions(saveFormat).
Krok 4: Export do Markdownu
MarkdownSaveOptions řídí export do Markdownu: ListExportMode a LinkExportMode určují, jak se zobrazují seznamy a hypertextové odkazy, ImagesFolder / ImagesFolderAlias kontrolují, kam se uloží extrahované obrázky a jak jsou odkazovány, ExportImagesAsBase64 je vkládá inline místo zapisování samostatných souborů, a TableContentAlignment ovlivňuje generovaný značkovací kód tabulek. Předávejte instanci MarkdownSaveOptions do Document.Save(fileName, saveOptions) s názvem souboru .md, nebo nastavte její SaveFormat explicitně.
Krok 5: Export do prostého textu
TxtSaveOptions (prostřednictvím svého sdíleného základu TxtSaveOptionsBase, který je také používán MarkdownSaveOptions) řídí export do prostého textu: Encoding nastavuje znakové kódování, ParagraphBreak nastavuje řetězec konce řádku, MaxCharactersPerLine zalamuje dlouhé řádky, SimplifyListLabels normalizuje odrážky a čísla seznamů na prosté znaky, a PreserveTableLayout udržuje sloupce tabulky zarovnané pomocí mezer.
Krok 6: Detekce formátu před konverzí
Před konverzí souboru neznámého formátu FileFormatUtil.DetectFileFormat(fileName) vrátí FileFormatInfo s detekovaným LoadFormat. Spojte jej s FileFormatUtil.LoadFormatToSaveFormat(loadFormat), abyste zkontrolovali, zda lze tento formát provést round-trip skrze podporované formáty této edice, než zavoláte Document.Save. Některé členy výčtu SaveFormat existují pro úplnost API, ale názvy formátů jsou v této omezené, open-source edici nepodporovány; držte se rodiny DOCX/DOCM/DOTX/DOTM/Flat OPC plus Markdown a prostého textu pro spolehlivý výstup.
Běžné problémy a opravy
Save(fileName) zapíše nesprávný formát. Přípona souboru neodpovídá zamýšlenému formátu. Použijte Save(fileName, saveFormat) or Save(fileName, saveOptions) aby byl formát explicitně určen místo spoléhaní se na příponu.
Uložený soubor OOXML se nepodaří otevřít pomocí hesla. OoxmlSaveOptions.Password nebyl nastaven před uložením. Vytvořte OoxmlSaveOptions, nastavte Password, a předávejte jej do Save.
Export do Markdownu neočekávaně rozptyluje soubory obrázků. Default MarkdownSaveOptions chování extrahuje obrázky do samostatných souborů. Nastavte ExportImagesAsBase64 = true pro jeden samostatný soubor Markdown, nebo nastavte ImagesFolder k ovládání, kam se obrázky umísťují.
Export do prostého textu ztrácí zarovnání sloupců tabulky. TxtSaveOptions.PreserveTableLayout zůstává ve výchozím nastavení. Nastavte PreserveTableLayout = true před uložením.
Často kladené otázky
Jak mohu uložit do konkrétního formátu bez ohledu na příponu souboru?
Zavolejte Save(fileName, saveFormat) s explicitní hodnotou SaveFormat, nebo Save(fileName, saveOptions) s odpovídající podtřídou SaveOptions.
Které formáty podporují round-trip v obou směrech v této edici?
DOCX, DOCM, DOTX, DOTM, Flat OPC (plus jejich makro-povolené a šablonové varianty), Markdown a prostý text.
Jak mohu chránit uložený soubor heslem, aby jej nebylo možné ani otevřít?
Nastavte Password na instanci OoxmlSaveOptions a předáte ji Document.Save(fileName, saveOptions).
Jak mohu kontrolovat konce řádků v exportovaném textovém souboru?
Nastavte ParagraphBreak na instanci TxtSaveOptions před uložením.
Jak mohu zkontrolovat formát souboru před jeho konverzí?
Zavolejte FileFormatUtil.DetectFileFormat(fileName) a přečtěte vrácený FileFormatInfo.LoadFormat.
