Hogyan exportáljunk és mentsünk Word dokumentumokat a .NET
Ez az útmutató bemutatja, hogyan exportáljunk és mentsünk egy Word-dokumentumot a Aspose.Words FOSS segítségével a .NET számára: mentés inferred vagy explicit formátummal, OOXML mentési beállítások konfigurálása, exportálás Markdownba, exportálás egyszerű szövegbe, és a fájl formátumának felismerése konvertálás előtt. A Aspose.Words FOSS a .NET számára elérhető a NuGet útján vagy forráskódból építve.
Lépésről-lépésre útmutató
1. lépés: Szerezd be a könyvtárat
Klónozd a repozitóriumot és építsd Aspose.Words.sln Release konfigurációban, majd adj hozzá egy projektreferenciát a Aspose.Words.csproj a saját .NET projektedből, ahogyan a Telepítési útmutató. Adj hozzá using Aspose.Words; a dokumentumokat mentő bármely fájl tetejére.
2. lépés: Mentés inferred vagy explicit formátummal
Document.Save(fileName) a célformátumot a fájl kiterjesztéséből következteti. Save(fileName, saveFormat) explicit módon állítja be a formátumot a kiterjesztéstől függetlenül, egy SaveFormat enum érték átvételével, és a Save(fileName, saveOptions) (vagy a megfelelő Stream túlterhelések) egy SaveOptions alosztályt vesznek a formátumspecifikus vezérléshez. SaveOptions.CreateSaveOptions(saveFormat) egy statikus gyár, amely visszaadja a megfelelő opciók alosztályát, amelynek alapértelmezett értékei már be vannak állítva egy adott SaveFormat esetén. Ez a kiadás teljes mértékben képes menteni és betölteni a DOCX, DOCM, DOTX, DOTM és Flat OPC formátumokat (plusz azok makró-engedélyezett és sablon változatai), valamint a Markdown és egyszerű szöveg formátumokat.
3. lépés: OOXML exportálási beállítások konfigurálása
OoxmlSaveOptions beállítja a mentést bármelyik Open XML változatra. A SaveFormat tulajdonsága kifejezetten a DOCX, DOCM, DOTX, DOTM vagy Flat OPC formátumot választja; a Password nyílt jelszót állít be a mentett fájlra, függetlenül Document.Protect szerkesztési korlátozásától; a Compliance az OOXML szigorúsági szintet választja; és a CompressionLevel / Zip64Mode szabályozzák az alapul szolgáló ZIP csomagolást. Készíts egyet a new OoxmlSaveOptions(saveFormat) segítségével vagy a SaveOptions.CreateSaveOptions(saveFormat) útján.
4. lépés: Exportálás Markdownba
MarkdownSaveOptions szabályozza a Markdown exportot: a ListExportMode és LinkExportMode határozzák meg, hogyan jelennek meg a listák és a hiperhivatkozások, a ImagesFolder / ImagesFolderAlias irányítják, hogy hova kerülnek a kinyert képek és hogyan hivatkoznak rájuk, a ExportImagesAsBase64 beágyazza őket beágyazottan ahelyett, hogy külön fájlokat írna, és a TableContentAlignment befolyásolja a generált táblázat jelölőnyelvet. Adj egy MarkdownSaveOptions példányt a Document.Save(fileName, saveOptions) részére egy .md fájlnévvel, vagy állítsd be explicit módon a SaveFormat értékét.
5. lépés: Exportálás egyszerű szövegbe
TxtSaveOptions (a közös alapja TxtSaveOptionsBase útján, amelyet a MarkdownSaveOptions is használ) szabályozza az egyszerű szöveg exportot: a Encoding állítja be a karakterkódolást, a ParagraphBreak adja meg a sorvége karakterláncot, a MaxCharactersPerLine tördeli a hosszú sorokat, a SimplifyListLabels normalizálja a lista jelölőket és számokat egyszerű karakterekké, és a PreserveTableLayout szóközökkel tartja igazítva a táblázat oszlopait.
6. lépés: Formátum felismerése konvertálás előtt
Mielőtt egy ismeretlen formátumú fájlt konvertálnánk, a FileFormatUtil.DetectFileFormat(fileName) egy FileFormatInfo objektumot ad vissza a felismert LoadFormat értékkel. Párosítsd a FileFormatUtil.LoadFormatToSaveFormat(loadFormat)-val, hogy ellenőrizd, a formátum körbejárható-visszafordítható-e a kiadás által támogatott formátumokon keresztül, mielőtt meghívnád a Document.Save-t. Néhány SaveFormat enum tag létezik a API teljessége érdekében, de a csökkentett, nyílt forráskódú kiadás nem valósít meg működő olvasót vagy írót ezekhez; maradj a DOCX/DOCM/DOTX/DOTM/Flat OPC családnál, valamint a Markdownnál és az egyszerű szövegnél a megbízható kimenetért.
Általános problémák és megoldások
Save(fileName) helytelen formátumot ír. A fájlkiterjesztés nem egyezik a kívánt formátummal. Használd Save(fileName, saveFormat) or Save(fileName, saveOptions) a formátum explicit megadásához a kiterjesztésre való támaszkodás helyett.
A mentett OOXML fájl jelszóval nem nyílik meg. OoxmlSaveOptions.Password nem lett beállítva a mentés előtt. Hozzon létre egy OoxmlSaveOptions, állítsa be Password, és adja át neki Save.
A Markdown export váratlanul szétteríti a képfájlokat. Default MarkdownSaveOptions a viselkedés a képeket külön fájlokba bontja. Állítsa be ExportImagesAsBase64 = true egy önálló Markdown fájlhoz, vagy állítsa be ImagesFolder a képek elhelyezésének vezérléséhez.
A egyszerű szöveg exportálása elveszíti a táblázat oszlopok igazítását. TxtSaveOptions.PreserveTableLayout alapértelmezett állapotban marad. Állítsa be PreserveTableLayout = true mentés előtt.
Gyakran feltett kérdések
Hogyan menthetek egy adott formátumba a fájlkiterjesztéstől függetlenül?
Hívja a Save(fileName, saveFormat) függvényt egy explicit SaveFormat értékkel, vagy a Save(fileName, saveOptions) függvényt egy megfelelő SaveOptions alosztállyal.
Mely formátumok round-trip műveletet támogatnak mindkét irányban ebben a kiadásban?
DOCX, DOCM, DOTX, DOTM, Flat OPC (plusz a makrókkal ellátott és sablonváltozataik), Markdown és egyszerű szöveg.
Hogyan tudok jelszóval védeni egy mentett fájlt, hogy egyáltalán ne lehessen megnyitni?
Állítsa be a Password értéket egy OoxmlSaveOptions példányon, és adja át a Document.Save(fileName, saveOptions) számára.
Hogyan szabályozhatom a sorvégeket egy exportált szövegfájlban?
Állítsa be a ParagraphBreak értéket egy TxtSaveOptions példányon, mielőtt mentené.
Hogyan ellenőrizhetem egy fájl formátumát, mielőtt konvertálnám?
Hívja meg a FileFormatUtil.DetectFileFormat(fileName) és olvassa a visszakapott FileFormatInfo.LoadFormat.
