A dokumentumbeállítások kezelése

Dokumentumbeállítások kezelése

A tartalmon túl egy Word-dokumentum alkalmazásszintű beállításokat tartalmaz – örökölt kompatibilitási kapcsolókat, elválasztási beállításokat, a tárolt mail-merge konfigurációt, nézetopciókat és a írásvédelem állapotát. Aspose.Words FOSS a .NET számára ezeket elérhetővé teszi a Aspose.Words.Settings névtérben és néhány tulajdonságon Document. Ez az oldal bemutatja az egyes beállításcsoportokat, valamint hogy mit vezérelnek és mit nem.

Kompatibilitási beállítások

Document.CompatibilityOptions egy CompatibilityOptions példány, amely tucatnyi logikai kapcsolót tartalmaz, amelyek reprodukálják a régebbi Word elrendezési és távolságkezelési viselkedéseket – például GrowAutofit, UseWord2010TableStyleRules, UseWord2002TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage, SpacingInWholePoints, UseFELayout és BalanceSingleByteDoubleByteWidth. Állítsd be a szükséges tulajdonságokat közvetlenül, hogy a dokumentumot olvasó downstream eszközök a konkrét Word verzió megjelenítési sajátosságainak megfelelően működjenek.

Elválasztási beállítások

Document.HyphenationOptions egy HyphenationOptions példány (AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps, HyphenationZone), amely a dokumentum Word elválasztási beállításait tárolja. Ezek a tulajdonságok körkörös úton továbbítják a kérést; mivel ez a kiadás nem tartalmazza az oldaltervező motorját, a Aspose.Words FOSS maga nem számolja ki az elválasztási pontokat – a Word alkalmazza őket, amikor megnyitja és lapozza a fájlt.

Levél-összevonás konfigurációja

Document.MailMergeSettings egy MailMergeSettings példány, amely a levél-összevonási konfigurációt tárolja, amely a dokumentumban rögzítve van: MainDocumentType, CheckErrors, Destination, DataSource, DataType, Query, ConnectString, MailSubject, MailAsAttachment, ActiveRecord és ViewMergedData, valamint Clear() és Clone(). A Word Office Data Source Object mechanizmusán keresztül csatlakoztatott külső adatforrások esetén a MailMergeSettings.Odso egy Odso példányt (DataSource, DataSourceType, TableName, ColumnDelimiter, FirstRowContainsColumnNames) tesz elérhetővé, amelynek FieldMapDatas (OdsoFieldMapDataCollection a OdsoFieldMapData esetén: Name, MappedName, Column, Type) és RecipientDatas (OdsoRecipientDataCollection a OdsoRecipientData esetén: Active, Column, Hash, UniqueTag) leírják a mezőleképezést és a címzettek listáját.

Dokumentumnézet beállításai

Document.ViewOptions egy ViewOptions példány, amely a Word fájl megnyitásakor történő megjelenítését szabályozza: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries és FormsDesign. Ezek a tulajdonságok csak a Word saját dokumentummegjelenítésére hatnak – nincs hatásuk arra, hogy a Aspose.Words FOSS maga hogyan dolgozza fel azt.

Írásvédelem

Document.WriteProtection egy WriteProtection példány (IsWriteProtected, ReadOnlyRecommended) SetPassword() a védelmi jelszó beállításához és ValidatePassword() a jelölt jelszó ellenőrzéséhez.

Mértékegységek

A MeasurementUnits felsorolt típus (enum) meghatározza, hogy a Word milyen mértékegységet használjon a felületén egy dokumentum esetén.

Tippek és bevált gyakorlatok

• CompatibilityOptions.OptimizeFor(MsWordVersion) jelen van az osztályban, de a megvalósítása ebben a buildben nem teljes – NotImplementedException kivételt dob. Állítsd be közvetlenül az egyes szükséges CompatibilityOptions logikai (boolean) tulajdonságokat, ahelyett, hogy a OptimizeFor -ra támaszkodnál egy teljes verzióprofil egyszerre történő alkalmazásához.
• MailMergeSettings and Odso tárolja a mail-merge configuration ami a dokumentumban rögzítve lett – a konfiguráció olvasása és írása támogatott, de a mail merge végrehajtása (mezők feltöltése élő adatforrásból) nem része ennek a nyílt forráskódú kiadásnak.
• HyphenationOptions és ViewOptions mindkettő a Word által alkalmazott megjelenítési/UI beállítás – ne számíts arra, hogy a Document.Save() meghívása megváltoztatja a szöveg tördelését vagy megjelenését ezek alapján, mivel ez a kiadás nem tartalmazza a page-layout motort.
• Hívd meg a WriteProtection.SetPassword() függvényt, mielőtt engedélyeznéd a IsWriteProtected -t, és használd a ValidatePassword() -t egy javasolt jelszó ellenőrzésére ahelyett, hogy magad tárolnád vagy összehasonlítanád a nyers karakterláncot.
• CompatibilityOptions, HyphenationOptions, MailMergeSettings, ViewOptions és WriteProtection közvetlenül elérhetők a Document -ból – nincs szükség a node tree keresésére.

Általános problémák

FAQ

Használhatom a Aspose.Words FOSS-t egy valódi mail merge futtatásához?

Nem. A MailMergeSettings és a Odso lehetővé teszik a dokumentumban tárolt összevonási konfiguráció olvasását és írását, de a levél-összevonás végrehajtása – a mezők adatforrásból való feltöltése – nem része ennek nyílt forráskódú kiadásnak.

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

Nem – ebben a verzióban NotImplementedException-t dob. Ehelyett közvetlenül állítsd be a szükséges egyedi CompatibilityOptions tulajdonságokat.

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

Hívd meg a WriteProtection.SetPassword() függvényt a Document.WriteProtection objektumon, majd állítsd be a IsWriteProtected értéket a védelem engedélyezéséhez.

Megváltoztatja a HyphenationOptions és a ViewOptions, hogy a dokumentum hogyan van elrendezve?

Nem. Mindkettő tárolt beállítás, amelyet a Microsoft Word alkalmaz a fájl megnyitásakor és megjelenítésekor. Ez a kiadás nem tartalmazza az oldal-elrendezés motorját, ezért ezek a beállítások áthaladnak anélkül, hogy a Aspose.Words FOSS maga számítaná ki az elrendezést.

API Reference összefoglaló

Lásd még:

• Aspose.Words for .NET — Enterprise Documentation