Werken met Documentinstellingen

Werken met documentinstellingen

Naast de inhoud bevat een Word-document toepassingsniveau-instellingen – legacy-compatibiliteitsschakelaars, voorkeuren voor woordafbreking, de opgeslagen mail-merge-configuratie, weergave-opties en de status van schrijfbeveiliging. Aspose.Words FOSS voor .NET legt deze bloot via de Aspose.Words.Settings namespace en een handvol eigenschappen op Document. Deze pagina behandelt elke instellingen-groep en wat deze wel en niet regelt.

Compatibiliteitsopties

Document.CompatibilityOptions is een CompatibilityOptions instantie die tientallen booleaanse schakelaars bevat die specifieke oudere Word-lay-out- en spatiëringsgedragingen reproduceren – bijvoorbeeld GrowAutofit, UseWord2010TableStyleRules, UseWord2002TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage, SpacingInWholePoints, UseFELayout en BalanceSingleByteDoubleByteWidth. Stel de eigenschappen die je nodig hebt direct in om de weergave-eigenaardigheden van een specifieke Word-versie te evenaren in downstream-gereedschap dat het document leest.

Afbreekvoorkeuren

Document.HyphenationOptions is een HyphenationOptions instantie (AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps, HyphenationZone) die de afbreekvoorkeuren van Word voor het document opslaat. Deze eigenschappen doorlopen de aanvraag heen en weer; omdat deze editie de paginalay-out-engine niet bevat, berekent Aspose.Words FOSS zelf geen afbreekpunten – Word past ze toe wanneer het het bestand opent en pagineert.

Mail-merge-configuratie

Document.MailMergeSettings is een MailMergeSettings instantie die de mail-merge-configuratie opslaat die is vastgelegd in het document: MainDocumentType, CheckErrors, Destination, DataSource, DataType, Query, ConnectString, MailSubject, MailAsAttachment, ActiveRecord en ViewMergedData, plus Clear() en Clone(). Voor externe gegevensbronnen die via het Office Data Source Object-mechanisme van Word zijn verbonden, geeft MailMergeSettings.Odso een Odso instantie weer (DataSource, DataSourceType, TableName, ColumnDelimiter, FirstRowContainsColumnNames) waarvan de FieldMapDatas (OdsoFieldMapDataCollection van OdsoFieldMapData: Name, MappedName, Column, Type) en RecipientDatas (OdsoRecipientDataCollection van OdsoRecipientData: Active, Column, Hash, UniqueTag) de veldtoewijzing en ontvangerslijst beschrijven.

Documentweergave-instellingen

Document.ViewOptions is een ViewOptions instantie die bepaalt hoe Word het bestand weergeeft wanneer het wordt geopend: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries en FormsDesign. Deze eigenschappen hebben alleen invloed op de weergave van het document door Word zelf – ze hebben geen effect op hoe Aspose.Words FOSS het document verwerkt.

Schrijfbescherming

Document.WriteProtection is een WriteProtection instantie (IsWriteProtected, ReadOnlyRecommended) met SetPassword() om een beveiligingswachtwoord in te stellen en ValidatePassword() om een voorgesteld wachtwoord te controleren.

Meeteenheden

De MeasurementUnits enum geeft de meeteenheid aan die Word in zijn interface voor een document moet gebruiken.

Tips en best practices

• CompatibilityOptions.OptimizeFor(MsWordVersion) is aanwezig op de klasse maar de implementatie is niet compleet in deze build – het gooit NotImplementedException. Stel de individuele CompatibilityOptions boolean-eigenschappen die je nodig hebt direct in plaats van te vertrouwen op OptimizeFor om in één keer een volledig versieprofiel toe te passen.
• MailMergeSettings and Odso opslaan van de mail-merge configuration die in het document is vastgelegd – lezen en schrijven van die configuratie wordt ondersteund, maar het uitvoeren van een mail merge (velden vullen vanuit een live gegevensbron) is niet opgenomen in deze open-source-editie.
• HyphenationOptions en ViewOptions zijn beide weergave-/UI-voorkeuren die Word zelf toepast – verwacht niet dat het aanroepen van Document.Save() de manier verandert waarop de tekst wordt afgebroken of verschijnt op basis van deze instellingen, aangezien deze editie de paginalay-out-engine niet bevat.
• Roep WriteProtection.SetPassword() aan voordat je IsWriteProtected inschakelt, en gebruik ValidatePassword() om een kandidaat-wachtwoord te controleren in plaats van zelf de ruwe tekenreeks op te slaan of te vergelijken.
• CompatibilityOptions, HyphenationOptions, MailMergeSettings, ViewOptions en WriteProtection zijn allemaal rechtstreeks toegankelijk vanuit Document – er is geen behoefte om de knooppuntboom ernaar te doorzoeken.

Veelvoorkomende problemen

FAQ

Kan ik Aspose.Words FOSS gebruiken om een echte mail merge uit te voeren?

Nee. MailMergeSettings en Odso stellen je in staat de samenvoegconfiguratie die in een document is opgeslagen te lezen en te schrijven, maar het uitvoeren van een mail merge – velden vullen vanuit een gegevensbron – is niet inbegrepen in deze open-source editie.

Werkt CompatibilityOptions.OptimizeFor()?

Nee – het gooit NotImplementedException in deze build. Stel in plaats daarvan de afzonderlijke CompatibilityOptions eigenschappen die je nodig hebt direct in.

Hoe kan ik een document met een wachtwoord beveiligen tegen bewerkingen?

Roep WriteProtection.SetPassword() aan op Document.WriteProtection, stel vervolgens IsWriteProtected in om bescherming in te schakelen.

Veranderen HyphenationOptions en ViewOptions hoe het document wordt opgemaakt?

Nee. Beide zijn opgeslagen voorkeuren die Microsoft Word toepast wanneer het het bestand opent en weergeeft. Deze editie bevat de pagina-indelingsengine niet, dus deze instellingen worden doorgegeven zonder dat Aspose.Words FOSS zelf de lay-out ervan berekent.

API Reference Samenvatting

Zie ook

• Aspose.Words for .NET — Enterprise Documentation