Felder aktualisieren

Normalerweise enthält ein in Microsoft Word eingefügtes Feld bereits einen aktuellen Wert. Wenn das Feld beispielsweise eine Formel oder eine Seitenzahl ist, enthält es den korrekten berechneten Wert für die angegebene Version des Dokuments. Wenn Sie jedoch eine Anwendung haben, die ein Dokument mit Feldern generiert oder ändert, z. B. das Zusammenführen von zwei Dokumenten oder das Auffüllen mit Daten, müssen im Idealfall alle Felder aktualisiert werden, damit das Dokument nützlich ist.

So aktualisieren Sie Felder

Wenn ein Dokument geladen wird, ahmt Aspose.Words das Verhalten von Microsoft Word nach, wobei die Option zum automatischen Aktualisieren von Feldern deaktiviert ist. Das Verhalten kann wie folgt zusammengefasst werden:

• wenn Sie ein Dokument öffnen / speichern, bleiben die Felder intakt
• Sie können bei Bedarf alle Felder in einem Dokument explizit aktualisieren, z. B. TOC neu erstellen
• wenn Sie auf PDF oder XPS rendern, werden die Felder für die Seitennummerierung in Kopf- / Fußzeilen aktualisiert
• wenn Sie mail merge ausführen, werden alle Felder automatisch aktualisiert

Felder programmgesteuert aktualisieren

Um Felder im gesamten Dokument explizit zu aktualisieren, rufen Sie einfach die Methode UpdateFields auf. Um Felder zu aktualisieren, die in einem Teil eines Dokuments enthalten sind, rufen Sie ein Range-Objekt ab und rufen Sie die UpdateFields-Methode auf. In Aspose.Words können Sie eine Range für jeden Knoten im Dokumentbaum erhalten, z. B.: Section, HeaderFooter, Paragraph, usw. verwenden der Eigenschaft Node.Range.Sie können das Ergebnis eines einzelnen Felds aktualisieren, indem Sie die Methode Update aufrufen.

Automatische Aktualisierung von seitenbezogenen Feldern während des Renderns

Wenn Sie die Konvertierung eines Dokuments in ein festes Seitenformat ausführen, z. B. in PDF oder XPS, aktualisiert Aspose.Words automatisch die seitenlayoutbezogenen Felder PAGE, PAGEREF in Kopf- /Fußzeilen des Dokuments. Dieses Verhalten ahmt das Verhalten von Microsoft Word beim Drucken eines Dokuments nach.

Wenn Sie alle anderen Felder im Dokument aktualisieren möchten, müssen Sie UpdateFields aufrufen, bevor Sie das Dokument rendern.

Das folgende Codebeispiel zeigt, wie alle Felder vor dem Rendern eines Dokuments aktualisiert werden:

Automatische Feldaktualisierung während Mail Merge

Wenn Sie eine mail merge ausführen, werden alle Felder im Dokument automatisch aktualisiert. Dies liegt daran, dass mail merge ein Fall einer Feldaktualisierung ist. Das Programm stößt auf ein mail merge -Feld und muss sein Ergebnis aktualisieren, wobei der Wert aus der Datenquelle abgerufen und in das Feld eingefügt wird. Die Logik ist natürlich komplizierter, zum Beispiel wenn das Ende des Bereichs Dokument / mail merge erreicht ist, aber noch weitere Daten zusammengeführt werden müssen, dann muss der Bereich dupliziert und der neue Satz von Feldern aktualisiert werden.

LastSavedTime -Eigenschaft vor dem Speichern aktualisieren

Sie können die Eigenschaft UpdateLastSavedTimeProperty verwenden, um die entsprechende integrierte Dokumenteigenschaft LastSavedTime beim Speichern des Dokuments zu aktualisieren.

Das folgende Codebeispiel zeigt, wie diese Eigenschaft aktualisiert wird: