Jak pracovat s nastavením dokumentu v .NET

Tento průvodce ukazuje, jak pracovat s nastavením dokumentu na úrovni aplikace v Aspose.Words FOSS pro .NET: spínače zpětné kompatibility, preference dělení slov, uloženou konfiguraci hromadné korespondence, možnosti zobrazení a ochranu proti zápisu. Aspose.Words FOSS pro .NET je k dispozici přes NuGet nebo sestavením ze zdrojového kódu.

Návod krok za krokem

Krok 1: Získat knihovnu

Klonejte repozitář a sestavte Aspose.Words.sln v konfiguraci Release, poté přidejte referenci na projekt do Aspose.Words.csproj z vašeho vlastního .NET projektu, jak je popsáno v instalačním průvodci. Přidejte using Aspose.Words; and using Aspose.Words.Settings; na začátek libovolného souboru, který čte nebo zapisuje nastavení dokumentu.

Krok 2: Nastavit možnosti zpětné kompatibility

Document.CompatibilityOptions (instance CompatibilityOptions) obsahuje desítky boolean spínačů, které reprodukují konkrétní starší chování rozvržení a mezery ve Wordu — například GrowAutofit, UseWord2010TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage a SpacingInWholePoints. Nastavte požadované vlastnosti přímo; OptimizeFor(MsWordVersion) je ve třídě přítomen, ale v této verzi vyvolává NotImplementedException, takže neexistuje žádná zkratka, která by najednou aplikovala celý profil verze.

Krok 3: Konfigurace předvoleb dělení slov

Document.HyphenationOptions (instance HyphenationOptions) ukládá předvolby dělení slov ve Wordu pro dokument: AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps a HyphenationZone. Tyto vlastnosti přenášejí požadavek při uložení souboru; protože tato edice nemá engine pro rozvržení stránek, samotné přerušení dělení slov jsou vypočítány Wordem při otevření a stránkování souboru, nikoli Aspose.Words FOSS.

Krok 4: Číst a zapisovat konfiguraci hromadné korespondence

Document.MailMergeSettings (instance MailMergeSettings) ukládá konfiguraci hromadné korespondence zaznamenanou v dokumentu — MainDocumentType, CheckErrors, Destination, DataSource, DataType, Query, ConnectString, MailSubject, MailAsAttachment, ActiveRecord a ViewMergedData — plus Clear() a Clone(). Pro externí zdroj dat připojený přes mechanismus Office Data Source Object ve Wordu, MailMergeSettings.Odso vystavuje instance Odso (DataSource, DataSourceType, TableName, ColumnDelimiter, FirstRowContainsColumnNames), jejíchž kolekce FieldMapDatas a RecipientDatas popisují mapování polí a seznam příjemců. Čtení a zápis této uložené konfigurace je v této open-source edici k dispozici; provádění samotného sloučení proti živému zdroji dat je samostatná záležitost mimo rozsah této stránky.

Krok 5: Konfigurace nastavení zobrazení dokumentu

Document.ViewOptions (instance ViewOptions) řídí, jak Word zobrazuje soubor po otevření: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries a FormsDesign. Tyto vlastnosti jsou uložené předvolby, které ovlivňují pouze vlastní zobrazení dokumentu ve Wordu — nemají žádný vliv na to, jak Aspose.Words FOSS sám soubor zpracovává.

Krok 6: Použít ochranu proti zápisu

Document.WriteProtection (instance WriteProtection) vystavuje IsWriteProtected a ReadOnlyRecommended, přičemž SetPassword() slouží k nastavení ochranného hesla a ValidatePassword() k ověření kandidátního hesla proti němu. Zavolejte SetPassword() před nastavením IsWriteProtected = true a použijte ValidatePassword() místo toho, abyste si sami ukládali nebo porovnávali surový řetězec hesla.

Časté problémy a opravy

CompatibilityOptions.OptimizeFor() throws NotImplementedException. Tato metoda není v tomto sestavení implementována. Nastavte jednotlivé CompatibilityOptions boolovské vlastnosti, které potřebujete, přímo místo toho.

Changing ViewOptions.ZoomPercent nemá žádný viditelný vliv na vygenerovaný výstup. ViewOptions je uložená předvolba zobrazení, kterou čte Word, a ne něco, co Aspose.Words FOSS sám aplikuje během zpracování. Oprava není potřeba — jedná se o očekávané chování.

WriteProtection.ValidatePassword() neočekávaně vrací false. SetPassword() nikdy nebyl zavolán, nebo bylo nastaveno jiné heslo. Zavolejte SetPassword() nejprve pro nastavení chráněného hesla před ověřením.

Konfigurace hromadné korespondence je uložena, ale sloučení se nespustí. MailMergeSettings and Odso uloží pouze konfiguraci sloučení; tato open-source edice nespouští samotné sloučení. Přečtěte si uloženou konfiguraci a použijte vlastní logiku pro vyplňování polí na jejím základě.

Často kladené otázky

Funguje `CompatibilityOptions.OptimizeFor()`?

Ne — v této verzi vyvolá NotImplementedException. Nastavte přímo jednotlivé požadované vlastnosti CompatibilityOptions.

Jak mohu dokument chránit heslem proti úpravám?

Zavolejte WriteProtection.SetPassword() na Document.WriteProtection, poté nastavte IsWriteProtected pro povolení ochrany.

Mění `HyphenationOptions` a `ViewOptions` vzhled dokumentu, když jej zpracovává Aspose.Words FOSS?

Ne. Obě jsou uložené předvolby, které Word sám použije při otevření a zobrazení souboru; tato verze nemá žádný engine pro rozvržení stránek, který by s nimi mohl přímo pracovat.

Kde najdu konfiguraci datového zdroje pro mail-merge u externího datového zdroje?

MailMergeSettings.Odso — jeho kolekce FieldMapDatas a RecipientDatas popisují mapování sloupců a stav zahrnutí příjemců.

Jaký je rozdíl mezi `Document.CompatibilityOptions` a `Document.ViewOptions`?

CompatibilityOptions přepínače reprodukují starší rozložení a zvláštnosti mezer ve Wordu; ViewOptions řídí, jak vlastní rozhraní Wordu zobrazuje soubor (zoom, formátovací značky). Ani jedno není vypočítáno samotným Aspose.Words FOSS.