Hogyan dolgozzunk a dokumentumbeállításokkal a .NET

Ez az útmutató bemutatja, hogyan kell kezelni az alkalmazásszintű dokumentumbeállításokat a Aspose.Words FOSS .NET számára: örökölt kompatibilitási kapcsolók, elválasztási beállítások, a tárolt levél-összefűzés konfigurációja, nézetbeállítások és írásvédelem. A Aspose.Words FOSS .NET számára elérhető a NuGet vagy a forráskódból történő fordítással.

Lépésről lépésre útmutató

1. lépés: Szerezd be a könyvtárat

Klónozd a repót é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, ahogy a Telepítési útmutató. Add using Aspose.Words; and using Aspose.Words.Settings; bármely, dokumentumbeállításokat olvasó vagy író fájl tetején.

2. lépés: Állítsd be az örökölt kompatibilitási beállításokat

Document.CompatibilityOptions (egy CompatibilityOptions példány) több tucat logikai kapcsolót tartalmaz, amelyek újra előállítják a régebbi Word elrendezés- és térközviselkedéseket — például GrowAutofit, UseWord2010TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage és SpacingInWholePoints. Állítsd be közvetlenül a szükséges egyedi tulajdonságokat; a OptimizeFor(MsWordVersion) jelen van az osztályban, de ebben a buildben NotImplementedException-t dob, így nincs olyan gyorsbillentyű, amely egyetlen lépésben alkalmazna egy teljes verzióprofilt.

3. lépés: Elválasztási beállítások konfigurálása

Document.HyphenationOptions (a HyphenationOptions példány) tárolja a Word elválasztási beállításait a dokumentumhoz: AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps és HyphenationZone. Ezek a tulajdonságok a kérést a mentett fájlban áteresztik; mivel ez a kiadás nem rendelkezik oldalelrendezési motorral, az elválasztási töréseket a Word számítja ki, amikor megnyitja és oldalakká osztja a fájlt, nem a Aspose.Words FOSS.

4. lépés: Körlevél konfigurációjának olvasása és írása

Document.MailMergeSettings (a MailMergeSettings példány) tárolja a dokumentumban rögzített körlevél konfigurációt — MainDocumentType, CheckErrors, Destination, DataSource, DataType, Query, ConnectString, MailSubject, MailAsAttachment, ActiveRecord és ViewMergedData — valamint Clear() és Clone(). Egy külső adatforráshoz, amely a Word Office Data Source Object mechanizmusán keresztül csatlakozik, a MailMergeSettings.Odso egy Odso példányt (DataSource, DataSourceType, TableName, ColumnDelimiter, FirstRowContainsColumnNames) tesz elérhetővé, amelynek FieldMapDatas és RecipientDatas gyűjteményei leírják a mezőleképezést és a címzettek listáját. Ennek a tárolt konfigurációnak az olvasása és írása elérhető ebben a nyílt forráskódú kiadásban; a körlevél futtatása élő adatforrással külön kérdés, amely kívül esik az oldal hatókörén.

5. lépés: Dokumentumnézet beállításainak konfigurálása

Document.ViewOptions (a ViewOptions példány) szabályozza, hogyan jeleníti meg a Word a fájlt megnyitáskor: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries és FormsDesign. Ezek a tulajdonságok tárolt beállítások, amelyek csak a Word saját dokumentummegjelenítésére hatnak — nincs hatásuk arra, hogy a Aspose.Words FOSS hogyan dolgozza fel azt.

6. lépés: Írásvédelem alkalmazása

Document.WriteProtection (a WriteProtection példány) elérhetővé teszi a IsWriteProtected és a ReadOnlyRecommended funkciókat, a SetPassword() segítségével beállítható egy védelmi jelszó, a ValidatePassword() pedig ellenőrzi a jelölt jelszót. Hívja meg a SetPassword() függvényt a IsWriteProtected = true beállítása előtt, és használja a ValidatePassword() módszert a nyers jelszókarakterlánc tárolása vagy összehasonlítása helyett.

Gyakori problémák és megoldások

CompatibilityOptions.OptimizeFor() throws NotImplementedException. Ez a metódus nincs megvalósítva ebben a buildben. Állítsd be az egyes CompatibilityOptions a szükséges logikai (boolean) tulajdonságokat közvetlenül.

Changing ViewOptions.ZoomPercent nem jár látható hatással a generált kimenetre. ViewOptions egy tárolt megjelenítési beállítás, amelyet a Word olvas, nem pedig a Aspose.Words FOSS maga alkalmaz a feldolgozás során. Javításra nincs szükség — ez várható.

WriteProtection.ValidatePassword() váratlanul visszaad false. SetPassword() soha nem lett meghívva, vagy más jelszó lett beállítva. Hívja meg SetPassword() először a védett jelszó beállításához, mielőtt érvényesítené.

A levél-összeillesztés beállítása mentésre kerül, de az összeillesztés nem fut le. MailMergeSettings and Odso csak az összeillesztés konfigurációját tárolja; ez a nyílt forráskódú kiadás nem hajtja végre magát az összeillesztést. Olvassa be a tárolt konfigurációt, és saját mezőkitöltő logikáját használja fel.

Gyakran ismételt kérdések

Működik a `CompatibilityOptions.OptimizeFor()`?

Nem — ebben a buildben NotImplementedException dob. Állítsd be közvetlenül a szükséges egyedi CompatibilityOptions tulajdonságokat.

Hogyan védhetek jelszóval egy dokumentumot a szerkesztés ellen?

Hívd meg a WriteProtection.SetPassword() elemet a Document.WriteProtection-on, majd állítsd be a IsWriteProtected értéket a védelem engedélyezéséhez.

A `HyphenationOptions` és a `ViewOptions` megváltoztatják a dokumentum megjelenését, amikor a Aspose.Words FOSS feldolgozza?

Nem. Mindkettő tárolt beállítás, amelyet a Word magától alkalmaz a fájl megnyitásakor és megjelenítésekor; ez a kiadás nem rendelkezik oldalelrendezési motorral, amely közvetlenül működne velük.

Hol találom a mail-merge adatforrás-konfigurációját egy külső adatforrás esetén?

MailMergeSettings.Odso — annak FieldMapDatas és RecipientDatas gyűjteményei írják le az oszlopleképezést és a címzett felvétel állapotát.

Mi a különbség a `Document.CompatibilityOptions` és a `Document.ViewOptions` között?

CompatibilityOptions kapcsolók reprodukálják a régebbi Word elrendezést és a szóközök sajátosságait; ViewOptions szabályozza, hogy a Word saját felülete hogyan jeleníti meg a fájlt (zoom, formázási jelek). Egyik sem kerül kiszámításra a Aspose.Words FOSS által.