ITextUpdateFile

Declaration

ITextFileUpdatesComponent : IDispatch

Overview

A Text File Update can be used to either create a new file with the specified content or to modify those existing using "Append" and "Search & Replace" operations. Multiple operations can be performed on the specified files.

Methods

NewAppendOrCreateOperation() - returns ITextUpdateAppendOrCreate
Creates a new text update operation for appending text to an existing file or create a new one with specified content.

NewReplaceOperation() - returns ITextUpdateFile
Creates a new text update operation for replacing text.

RemoveOperation(Object Operation);
Removes and destroys a file update operation object.

Properties

String Include
Gets or sets the name of the file that will be created or modified. It is possible to define wildcards (e.g:*.txt).

String Exclude
Gets or sets the name of the file which won't be modified. It is possible to define wildcards.

Bool SearchSubfolders
Gets or sets the property of the operation to search in all the directories contained in the current folder the file(s) specified in the "Include" and "Exclude" fields.

String ExecuteTime
Gets or sets the time the operation will be executed. Supported values: ”install”, “uninstall”, “both”.

Bool AbortInstallationOnError
Gets or sets the way windows installer threats the execution file of the operation: abort installation and rollback or skip the file and restore the original state.

Bool CreateBackupFileBeforeUpdate
Gets or sets the property of the operation to create a backup file before execution. In some cases, the operation will have undesired results. It is advised to enable this option in case such an event occurs. This way the file can be restored to it's unchanged, original state from the backup copy generated before the operation took place.

Bool ImpersonateInstallingUser
Gets or sets the property of the operation for user installing the application, not under the Local System account.

ITextUpdateAppendOrCreate CreateOrUpdateOperation
Gets the text update operation for creating or updating an existing file.

Array<ITextUpdateReplace> ReplaceOperations
Gets the collection of text updates to replace operations.

IComponent Component
Gets the component which will contain the text update.

See also

ITextFileUpdatesComponent

ITextUpdateAppendOrCreate