Delphi Database, Delphi Components from ComponentAce

TZipForge.UpdateFiles
TZipForge Example

Top

Updates files stored within the archive.

procedure UpdateFiles; overload;
procedure UpdateFiles(
         FileMask:    String;
         SearchAttr:    Word = faAnyFile;
         ExclusionMask: String = ''); overload;

Description
Use UpdateFiles to update files stored within the open archive file. UpdateFiles searches for extrenal files specified by FileMask,SearchAttr and ExclusionMask parameters and BaseDir property and synchronizes them with files stored within the archive. UpdateFiles uses Options.OverwriteMode to determine how to overwrite existing files inside the archive with external files from BaseDir. If Options.Recurse is set to True, UpdateFiles will search files recursively.

UpdateFiles variant without parameters uses FileMasks, ExclusionMasks and Options.SearchAttr to specify search conditions and to exclude files from update operation.

The FileMask parameter is the directory and file name mask, including wildcard characters. For example, 'TEST\*.*' specifies all files in the TEST directory stored within the archive file. All files that meets FileMask and SearchAttr will be updated.

The SearchAttr parameter specifies the special files to include in addition to all normal files. This parameter is similar to the Attr parameter in FindFirst function from SysUtils unit. You can set it to any combination of faReadOnly, faHidden, faSysFile, faVolumeID, faDirectory, faArchive constants defined in SysUtils or value faAnyFile meaning that any file meets search condition.

The ExclusionMask specifies files to be excluded from update operation.

Note: If you need to update certain files without compression set NoCompressionMasks property. If some errors occurs an exception will be raised. Write an OnProcessFileFailure event handler to perform your own error handling.

Dec 26, 2024