Type Default Value Read Only Description

[Visual Basic]
false No Whether to use incremental update to preserve an audit trail.




This property determines if incremental update should be used.

Incremental update leaves the structure of any original document intact and appends any changes to the end of the file.

Because the original PDF is unchanged it is possible to revert back to the state before the changes were applied. Because only updated objects are written to disk it can result in faster write times.

However most importantly you have to use incremental update if you wish to preserve any signed signature fields present in the document. Indeed after any signature field is signed you need to commit changes to file using incremental update.

Incremental Update is incompatible with the Linearization, Remapping and CompressObjects options. As such it will override these settings.

If you are incrementally updating an encrypted document the encryption settings must remain identical between incremental updates. For this reason it is important to read the document in a particular way. Only one password is required to Doc.Read an encrypted document but to save it two passwords are required. For this reason it is important to read the document using the user password (typically blank) and then set both the Doc.Encryption.Password and the Doc.Encryption.OwnerPassword before doing an incremental save. You need to know both passwords in order to update the document.