Робота з налаштуваннями документа

Робота з налаштуваннями документа

Окрім вмісту, документ Word містить налаштування рівня додатка — перемикачі сумісності зі старими версіями, параметри переносу слів, збережену конфігурацію злиття листів, параметри перегляду та стан захисту від запису. Aspose.Words FOSS для .NET надає їх через Aspose.Words.Settings простір імен та низку властивостей у Document. На цій сторінці розглядаються кожна група налаштувань та те, що вона контролює і чого не контролює.

Опції сумісності

Document.CompatibilityOptions — це екземпляр CompatibilityOptions, який містить десятки булевих перемикачів, що відтворюють певні старіший-Word макетні та інтервальні поведінки — наприклад GrowAutofit, UseWord2010TableStyleRules, UseWord2002TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage, SpacingInWholePoints, UseFELayout та BalanceSingleByteDoubleByteWidth. Встановіть потрібні властивості безпосередньо, щоб відповідати особливостям відображення конкретної версії Word у подальших інструментах, які читають документ.

Налаштування перенесення слів

Document.HyphenationOptions — це екземпляр HyphenationOptions (AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps, HyphenationZone), який зберігає налаштування перенесення слів Word для документа. Ці властивості передають запит у обидва напрямки; оскільки ця версія не включає движок розташування сторінок, Aspose.Words FOSS самостійно не обчислює розриви перенесень — Word застосовує їх під час відкриття та пагінації файлу.

Конфігурація злиття пошти

Document.MailMergeSettings — це MailMergeSettings екземпляр, який зберігає конфігурацію поштового злиття, записану в документі: MainDocumentType, CheckErrors, Destination, DataSource, DataType, Query, ConnectString, MailSubject, MailAsAttachment, ActiveRecord та ViewMergedData, а також Clear() і Clone(). Для зовнішніх джерел даних, підключених через механізм Office Data Source Object у Word, MailMergeSettings.Odso надає Odso екземпляр (DataSource, DataSourceType, TableName, ColumnDelimiter, FirstRowContainsColumnNames), чий FieldMapDatas (OdsoFieldMapDataCollection OdsoFieldMapData: Name, MappedName, Column, Type) та RecipientDatas (OdsoRecipientDataCollection OdsoRecipientData: Active, Column, Hash, UniqueTag) описують зіставлення полів і список одержувачів.

Налаштування перегляду документа

Document.ViewOptions — це ViewOptions екземпляр, який контролює, як Word відображає файл при його відкритті: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries та FormsDesign. Ці властивості впливають лише на відображення документа у Word — вони не впливають на те, як Aspose.Words FOSS сам обробляє його.

Захист від запису

Document.WriteProtection — це WriteProtection екземпляр (IsWriteProtected, ReadOnlyRecommended) з SetPassword() для встановлення пароля захисту та ValidatePassword() для перевірки запропонованого пароля.

Одиниці вимірювання

Перелічення MeasurementUnits визначає одиницю вимірювання, яку Word має використовувати у своєму інтерфейсі для документа.

Поради та найкращі практики

• CompatibilityOptions.OptimizeFor(MsWordVersion) присутній у класі, але його реалізація у цій збірці не завершена — він генерує NotImplementedException. Встановіть окремі логічні властивості CompatibilityOptions, які вам потрібні, безпосередньо, замість того, щоб покладатися на OptimizeFor для застосування цілого профілю версії одразу.
• MailMergeSettings and Odso зберігати злиття листів configuration яке було записано у документі — читання та запис цієї конфігурації підтримуються, але виконання злиття листів (заповнення полів з живого джерела даних) не включено у цю відкриту версію.
• HyphenationOptions і ViewOptions — це налаштування відображення/UI, які застосовує сам Word — не очікуйте, що виклик Document.Save() змінить спосіб переносу чи вигляд тексту відповідно до цих налаштувань, оскільки ця редакція не містить движка розмітки сторінки.
• Викличте WriteProtection.SetPassword() перед увімкненням IsWriteProtected і використайте ValidatePassword() для перевірки кандидатного пароля замість того, щоб зберігати або порівнювати сам рядок.
• CompatibilityOptions, HyphenationOptions, MailMergeSettings, ViewOptions і WriteProtection доступні безпосередньо через Document — немає потреби шукати їх у дереві вузлів.

Поширені проблеми

FAQ

Чи можу я використовувати Aspose.Words FOSS для виконання реального поштового злиття?

Ні. MailMergeSettings і Odso дозволяють читати та записувати конфігурацію злиття, збережену в документі, але виконання поштового злиття — заповнення полів з джерела даних — не входить у цю відкриту редакцію.

Чи працює CompatibilityOptions.OptimizeFor()?

Ні — вона викидає NotImplementedException у цій збірці. Натомість встановіть потрібні окремі властивості CompatibilityOptions безпосередньо.

Як захистити документ паролем від редагування?

Викличте WriteProtection.SetPassword() на Document.WriteProtection, потім встановіть IsWriteProtected, щоб увімкнути захист.

Чи змінюють HyphenationOptions і ViewOptions розташування документа?

Ні. Обидва — це збережені налаштування, які Microsoft Word застосовує під час відкриття та відображення файлу. У цій редакції не включено движок розташування сторінок, тому ці налаштування проходять без Aspose.Words FOSS, який би сам обчислював розмітку за їхньою допомогою.

API Reference Огляд

Дивіться також

• Aspose.Words for .NET — Enterprise Documentation