Cum să lucrați cu setările documentului în .NET
Acest ghid arată cum să lucraţi cu setările documentului la nivel de aplicație în Aspose.Words FOSS pentru .NET: comutatoare de compatibilitate moştenite, preferinţe de despărţire silabică, configuraţia stocată de îmbinare de corespondenţă, opţiuni de vizualizare şi protecţie la scriere. Aspose.Words FOSS pentru .NET este disponibil prin NuGet sau prin compilare din sursă.
Ghid pas cu pas
Pasul 1: Obţineţi biblioteca
Clonaţi depozitul şi construiţi Aspose.Words.sln în configuraţia Release, apoi adăugaţi o referinţă de proiect la Aspose.Words.csproj din propriul dumneavoastră proiect .NET, aşa cum se descrie în ghidul de instalare. Adăugaţi using Aspose.Words; and using Aspose.Words.Settings; în partea de sus a oricărui fişier care citeşte sau scrie setările documentului.
Pasul 2: Configuraţi opţiunile de compatibilitate moştenită
Document.CompatibilityOptions (o instanţă CompatibilityOptions) conţine zeci de comutatoare booleene care reproduc comportamente specifice de aspect şi spaţiere ale versiunilor mai vechi de Word — de exemplu GrowAutofit, UseWord2010TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage şi SpacingInWholePoints. Configuraţi direct proprietăţile individuale de care aveţi nevoie; OptimizeFor(MsWordVersion) este prezentă în clasă, dar aruncă NotImplementedException în această construcţie, aşa că nu există o scurtătură care să aplice un întreg profil de versiune dintr-odată.
Pasul 3: Configurați preferințele de despărțire în silabe
Document.HyphenationOptions (o instanță HyphenationOptions) stochează preferințele de despărțire în silabe ale Word pentru documentul: AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps și HyphenationZone. Aceste proprietăți transportă cererea în fișierul salvat; deoarece această ediție nu are motor de aranjare a paginii, întreruperile de silabisare sunt calculate de Word când deschide și paginează fișierul, nu de Aspose.Words FOSS.
Pasul 4: Citiți și scrieți configurația de îmbinare a corespondenței
Document.MailMergeSettings (o instanță MailMergeSettings) stochează configurația de îmbinare a corespondenței înregistrată în document — MainDocumentType, CheckErrors, Destination, DataSource, DataType, Query, ConnectString, MailSubject, MailAsAttachment, ActiveRecord și ViewMergedData — plus Clear() și Clone(). Pentru o sursă de date externă conectată prin mecanismul Office Data Source Object al Word, MailMergeSettings.Odso expune o instanță Odso (DataSource, DataSourceType, TableName, ColumnDelimiter, FirstRowContainsColumnNames), ale cărei colecții FieldMapDatas și RecipientDatas descriu maparea câmpurilor și lista de destinatari. Citirea și scrierea acestei configurații stocate este disponibilă în această ediție open-source; rularea efectivă a îmbinării împotriva unei surse de date live este o problemă separată, în afara domeniului acestei pagini.
Pasul 5: Configurați setările de vizualizare a documentului
Document.ViewOptions (o instanță ViewOptions) controlează modul în care Word afișează fișierul odată deschis: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries și FormsDesign. Aceste proprietăți sunt preferințe stocate care influențează doar afișarea documentului de către Word — nu au nicio influență asupra modului în care Aspose.Words FOSS procesează fișierul.
Pasul 6: Aplicați protecția la scriere
Document.WriteProtection (o instanță WriteProtection) expune IsWriteProtected și ReadOnlyRecommended, cu SetPassword() pentru a stabili o parolă de protecție și ValidatePassword() pentru a verifica o parolă candidat împotriva acesteia. Apelați SetPassword() înainte de a seta IsWriteProtected = true și utilizați ValidatePassword() în loc să stocați sau să comparați șirul brut al parolei voi înșivă.
Probleme comune și remedii
CompatibilityOptions.OptimizeFor() throws NotImplementedException. Această metodă nu este implementată în această construcție. Setaţi proprietăţile individuale CompatibilityOptions boolean de care aveţi nevoie direct, în schimb.
Changing ViewOptions.ZoomPercent nu are niciun efect vizibil asupra ieșirii generate. ViewOptions este o preferință de afișare stocată citită de Word, nu ceva ce Aspose.Words FOSS aplică în timpul procesării. Nu este necesară nicio corecție — acest lucru este așteptat.
WriteProtection.ValidatePassword() returnează neașteptat false. SetPassword() nu a fost niciodată apelat, sau a fost setată o parolă diferită. Apelă SetPassword() mai întâi pentru a stabili parola protejată înainte de validare.
Configurația de îmbinare prin corespondență este salvată, dar îmbinarea nu se execută. MailMergeSettings and Odso stochează doar configurația de îmbinare; această ediție open-source nu execută îmbinarea în sine. Citește configurația stocată și implementează propria logică de populare a câmpurilor pe baza ei.
Întrebări frecvente
Funcționează CompatibilityOptions.OptimizeFor()?
Nu — aruncă NotImplementedException în această versiune. Setează direct proprietățile individuale CompatibilityOptions de care ai nevoie.
Cum pot să protejez cu parolă un document împotriva editărilor?
Apelează WriteProtection.SetPassword() pe Document.WriteProtection, apoi setează IsWriteProtected pentru a activa protecția.
Modifică HyphenationOptions și ViewOptions aspectul documentului când Aspose.Words FOSS îl procesează?
Nu. Ambele sunt preferințe stocate pe care Word le aplică când deschide și afișează fișierul; această ediție nu are niciun motor de layout de pagină care să le proceseze direct.
Unde pot găsi configurația sursei de date pentru fuziunea de corespondență cu o sursă de date externă?
MailMergeSettings.Odso — colecțiile sale FieldMapDatas și RecipientDatas descriu maparea coloanelor și starea includerii destinatarului.
Care este diferența dintre Document.CompatibilityOptions și Document.ViewOptions?
CompatibilityOptions comutatoarele reproduc aspectul și ciudățeniile de spațiere ale versiunilor mai vechi de Word; ViewOptions controlează modul în care interfața proprie a Word afișează fișierul (zoom, marcaje de formatare). Niciunul nu este calculat de Aspose.Words FOSS în sine.
