Wie man mit Dokumenteinstellungen in .NET arbeitet
Dieser Leitfaden zeigt, wie man mit dokumentenbezogenen Anwendungseinstellungen in Aspose.Words FOSS für .NET arbeitet: Legacy-Kompatibilitäts-Schalter, Silbentrennungs-Präferenzen, die gespeicherte Mail-Merge-Konfiguration, Anzeigeoptionen und Schreibschutz. Aspose.Words FOSS für .NET ist über NuGet oder durch Kompilieren aus dem Quellcode verfügbar.
Schritt-für-Schritt-Anleitung
Schritt 1: Bibliothek holen
Klonen Sie das Repository und bauen Sie es Aspose.Words.sln in Release-Konfiguration, dann fügen Sie einen Projektverweis zu Aspose.Words.csproj aus Ihrem eigenen .NET-Projekt, wie im Installationsanleitung. Hinzufügen using Aspose.Words; and using Aspose.Words.Settings; am Anfang jeder Datei, die Dokumenteinstellungen liest oder schreibt.
Schritt 2: Legacy-Kompatibilitätsoptionen festlegen
Document.CompatibilityOptions (eine CompatibilityOptions-Instanz) enthält Dutzende von booleschen Schaltern, die bestimmte ältere Word-Layout- und Abstandverhalten nachbilden — zum Beispiel GrowAutofit, UseWord2010TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage und SpacingInWholePoints. Setzen Sie die einzelnen benötigten Eigenschaften direkt; OptimizeFor(MsWordVersion) ist in der Klasse vorhanden, wirft jedoch NotImplementedException in diesem Build, sodass es keine Abkürzung gibt, die ein ganzes Versionsprofil auf einmal anwendet.
Schritt 3: Silbentrennungseinstellungen konfigurieren
Document.HyphenationOptions (eine HyphenationOptions Instanz) speichert die Silbentrennungseinstellungen von Word für das Dokument: AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps und HyphenationZone. Diese Eigenschaften transportieren die Anforderung im gespeicherten Dateiformat; da diese Ausgabe keine Seitenlayout-Engine hat, werden die eigentlichen Silbentrennungsumbrüche von Word berechnet, wenn es die Datei öffnet und paginiert, nicht von Aspose.Words FOSS.
Schritt 4: Mail-Merge-Konfiguration lesen und schreiben
Document.MailMergeSettings (eine MailMergeSettings Instanz) speichert die im Dokument aufgezeichnete Mail-Merge-Konfiguration — MainDocumentType, CheckErrors, Destination, DataSource, DataType, Query, ConnectString, MailSubject, MailAsAttachment, ActiveRecord und ViewMergedData — sowie Clear() und Clone(). Für eine externe Datenquelle, die über Word’s Office Data Source Object-Mechanismus angebunden ist, stellt MailMergeSettings.Odso eine Odso Instanz bereit (DataSource, DataSourceType, TableName, ColumnDelimiter, FirstRowContainsColumnNames), deren FieldMapDatas- und RecipientDatas-Sammlungen das Feld-Mapping und die Empfängerliste beschreiben. Das Lesen und Schreiben dieser gespeicherten Konfiguration ist in dieser Open-Source-Ausgabe verfügbar; das eigentliche Durchführen des Merges gegen eine Live-Datenquelle ist ein separater Aspekt, der außerhalb des Umfangs dieser Seite liegt.
Schritt 5: Ansichtseinstellungen des Dokuments konfigurieren
Document.ViewOptions (eine ViewOptions Instanz) steuert, wie Word die Datei nach dem Öffnen anzeigt: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries und FormsDesign. Diese Eigenschaften sind gespeicherte Präferenzen, die nur die Anzeige des Dokuments in Word beeinflussen — sie haben keinen Einfluss darauf, wie Aspose.Words FOSS das Dokument selbst verarbeitet.
Schritt 6: Schreibschutz anwenden
Document.WriteProtection (eine WriteProtection Instanz) stellt IsWriteProtected und ReadOnlyRecommended bereit, mit SetPassword() zum Festlegen eines Schutzkennworts und ValidatePassword() zum Überprüfen eines Kandidatenkennworts. Rufen Sie SetPassword() auf, bevor Sie IsWriteProtected = true setzen, und verwenden Sie ValidatePassword() anstelle des direkten Speicherns oder Vergleichens des rohen Kennwort-Strings.
Häufige Probleme und Lösungen
CompatibilityOptions.OptimizeFor() throws NotImplementedException. Diese Methode ist in diesem Build nicht implementiert. Setzen Sie die einzelnen CompatibilityOptions booleschen Eigenschaften, die Sie benötigen, direkt stattdessen.
Changing ViewOptions.ZoomPercent hat keine sichtbare Auswirkung auf die erzeugte Ausgabe. ViewOptions ist eine gespeicherte Anzeigeeinstellung, die von Word gelesen wird, und nicht etwas, das Aspose.Words FOSS selbst während der Verarbeitung anwendet. Keine Korrektur nötig — das ist beabsichtigt.
WriteProtection.ValidatePassword() gibt unerwartet zurück false. SetPassword() wurde nie aufgerufen, oder ein anderes Passwort wurde gesetzt. Rufen Sie SetPassword() zuerst auf, um das geschützte Passwort festzulegen, bevor Sie validieren.
Die Seriendruckkonfiguration wird gespeichert, aber der Seriendruck wird nicht ausgeführt. MailMergeSettings and Odso speichert nur die Seriendruckkonfiguration; diese Open-Source-Edition führt den Seriendruck nicht selbst aus. Lesen Sie die gespeicherte Konfiguration und steuern Sie Ihre eigene Feldbefüllungslogik damit.
Häufig gestellte Fragen
Funktioniert CompatibilityOptions.OptimizeFor()?
Nein — es wirft NotImplementedException in diesem Build. Setzen Sie die einzelnen CompatibilityOptions-Eigenschaften, die Sie benötigen, direkt.
Wie schütze ich ein Dokument mit einem Passwort vor Bearbeitungen?
Rufen Sie WriteProtection.SetPassword() für Document.WriteProtection auf und setzen Sie dann IsWriteProtected, um den Schutz zu aktivieren.
Verändern HyphenationOptions und ViewOptions, wie das Dokument aussieht, wenn Aspose.Words FOSS es verarbeitet?
Nein. Beide sind gespeicherte Einstellungen, die Word selbst beim Öffnen und Anzeigen der Datei anwendet; diese Ausgabe verfügt über keine Seitenlayout-Engine, die sie direkt verarbeiten könnte.
Wo finde ich die mail-merge Datenquellenkonfiguration für eine externe Datenquelle?
MailMergeSettings.Odso — seine FieldMapDatas- und RecipientDatas-Sammlungen beschreiben die Spaltenzuordnung und den Einschlussstatus der Empfänger.
Was ist der Unterschied zwischen Document.CompatibilityOptions und Document.ViewOptions?
CompatibilityOptions Schalter reproduzieren das ältere Word-Layout und Abstandsanomalien; ViewOptions steuert, wie die Word-eigene Oberfläche die Datei anzeigt (Zoom, Formatierungszeichen). Keines davon wird von Aspose.Words FOSS selbst berechnet.
