Cum să exportați și să salvați documente Word în .NET
Acest ghid arată cum să exportați și să salvați un document Word cu Aspose.Words FOSS pentru .NET: salvarea cu un format inferat sau explicit, configurarea opțiunilor de salvare OOXML, exportarea în Markdown, exportarea în text simplu și detectarea formatului unui fișier înainte de a-l converti. Aspose.Words FOSS pentru .NET este disponibil prin NuGet sau prin compilare din sursă.
Ghid pas cu pas
Pasul 1: Obțineți biblioteca
Clonați depozitul și construiți Aspose.Words.sln în configurația Release, apoi adăugați o referință de proiect la Aspose.Words.csproj din propriul proiect .NET, așa cum se descrie în Ghidul de instalare. Adăugați using Aspose.Words; în partea de sus a oricărui fișier care salvează documente.
Pasul 2: Salvați cu un format inferat sau explicit
Document.Save(fileName) inferă formatul țintă din extensia fișierului. Save(fileName, saveFormat) face formatul explicit, indiferent de extensie, primind o valoare enum SaveFormat, și Save(fileName, saveOptions) (sau suprasarcinile corespunzătoare Stream) primește o subclasă SaveOptions pentru control specific formatului. SaveOptions.CreateSaveOptions(saveFormat) este o fabrică statică care returnează subclasa de opțiuni corespunzătoare cu valorile implicite deja setate pentru un anumit SaveFormat. Această ediție salvează complet atât în, cât și din DOCX, DOCM, DOTX, DOTM și Flat OPC (plus variantele lor cu macrocomenzi și șabloane), precum și în Markdown și text simplu.
Pasul 3: Configurați opțiunile de export OOXML
OoxmlSaveOptions configurează salvarea în oricare dintre variantele Open XML. Proprietatea sa SaveFormat selectează DOCX, DOCM, DOTX, DOTM sau Flat OPC în mod specific; Password stabilește o parolă de deschidere pentru fișierul salvat, independent de restricția de editare a Document.Protect; Compliance selectează nivelul de strictețe OOXML; iar CompressionLevel / Zip64Mode controlează ambalarea ZIP de bază. Construiți una cu new OoxmlSaveOptions(saveFormat) sau prin SaveOptions.CreateSaveOptions(saveFormat).
Pasul 4: Exportați în Markdown
MarkdownSaveOptions controlează exportul în Markdown: ListExportMode și LinkExportMode reglementează cum sunt afișate listele și legăturile hipertext, ImagesFolder / ImagesFolderAlias controlează unde sunt plasate imaginile extrase și cum sunt referențiate, ExportImagesAsBase64 le încorporează în linie în loc să scrie fișiere separate, iar TableContentAlignment influențează markup-ul tabelului generat. Transmiteți o instanță MarkdownSaveOptions către Document.Save(fileName, saveOptions) cu un nume de fișier .md, sau setați explicit SaveFormat.
Pasul 5: Exportați în text simplu
TxtSaveOptions (prin baza sa comună TxtSaveOptionsBase, utilizată și de MarkdownSaveOptions) controlează exportul în text simplu: Encoding stabilește codificarea caracterelor, ParagraphBreak stabilește șirul de terminare a liniei, MaxCharactersPerLine înfășoară liniile lungi, SimplifyListLabels normalizează marcatorii și numerotarea listelor la caractere simple, iar PreserveTableLayout menține coloanele tabelului aliniate utilizând spații.
Pasul 6: Detectați un format înainte de conversie
Înainte de a converti un fișier cu format necunoscut, FileFormatUtil.DetectFileFormat(fileName) returnează un FileFormatInfo cu LoadFormat detectat. Împerecheați-l cu FileFormatUtil.LoadFormatToSaveFormat(loadFormat) pentru a verifica dacă acel format poate parcurge un ciclu complet prin formatele suportate de această ediție înainte de a apela Document.Save. Unele SaveFormat membri enum există pentru completitudinea API, dar formatul numit în această ediție redusă, open-source, nu implementează un cititor sau scriitor funcțional; rămâneți la familia DOCX/DOCM/DOTX/DOTM/Flat OPC plus Markdown și text simplu pentru rezultate fiabile.
Probleme comune și remedii
Save(fileName) scrie în format greșit. Extensia fișierului nu corespunde formatului dorit. Utilizați Save(fileName, saveFormat) or Save(fileName, saveOptions) pentru a face formatul explicit în loc să ne bazăm pe extensie.
Fișierul OOXML salvat nu se va deschide cu parolă. OoxmlSaveOptions.Password nu a fost setat înainte de salvare. Construiește un OoxmlSaveOptions, setează Password, și transmite-l către Save.
Exportul Markdown împrăștie fișierele imagine neașteptat. Default MarkdownSaveOptions comportamentul extrage imaginile în fișiere separate. Setează ExportImagesAsBase64 = true pentru un singur fișier Markdown autonom, sau setează ImagesFolder pentru a controla unde se plasează imaginile.
Exportul în format text simplu pierde alinierea coloanelor din tabel. TxtSaveOptions.PreserveTableLayout este lăsat la valoarea implicită. Set PreserveTableLayout = true înainte de salvare.
Întrebări frecvente
Cum pot salva într-un format specific, indiferent de extensia fișierului?
Apelă Save(fileName, saveFormat) cu o valoare SaveFormat explicită, sau Save(fileName, saveOptions) cu o subclasă SaveOptions corespunzătoare.
Ce formate pot fi convertite în ambele sensuri în această ediție?
DOCX, DOCM, DOTX, DOTM, Flat OPC (plus variantele lor cu macrocomenzi și cele de șablon), Markdown și text simplu.
Cum pot proteja cu parolă un fișier salvat astfel încât să nu poată fi nici măcar deschis?
Setează Password pe o instanță OoxmlSaveOptions și transmite-o lui Document.Save(fileName, saveOptions).
Cum pot controla sfârșiturile de linie într-un fișier text exportat?
Setează ParagraphBreak pe o instanță TxtSaveOptions înainte de a salva.
Cum pot verifica formatul unui fișier înainte de a-l converti?
Apelă FileFormatUtil.DetectFileFormat(fileName) și citește FileFormatInfo.LoadFormat returnat.
