Helps users synchronize a directory on an FTP server with one on the local machine.
For a list of all members of this type, see FTPSynchronizeView Members.
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.ScrollableControl
System.Windows.Forms.ContainerControl
System.Windows.Forms.UserControl
EnterpriseDT.Net.Ftp.Forms.FTPSynchronizeView
Public static (Shared in Visual Basic) members of this type are safe for multithreaded operations. Instance members are not guaranteed to be thread-safe.
FTPSynchronizeView presents the user with a comparison of the files in the current working directory on the server (ServerDirectory) with those in the working directory on the local machine (LocalDirectory).
Files are matched by name with optional case-sensitivity (see IgnoreCase). The comparison is presented in the form a ListView with one row for each matching pair of files and with columns showing the names, dates, size of these files, as well as a description of how their dates and sizes compare, and a what action would be required to synchronize them.
A check-box is displayed next to each file, which allows the user to determine whether or not the suggested action should be performed. A synchronize button is displayed in the top-right corner (by default). When it is pressed all of the checked actions will be performed.
FTPSynchronizeView is highly customizable. The following table shows different ways of controlling the file comparisons:
| Behavior | Properties |
|---|---|
| Transfer direction | Direction determines whether files are to be uploaded or downloaded. |
| Case sensitivity | IgnoreCase |
| File-name filtering | FileNameFilter, FilterType and ExcludeFilesInFilter |
| Date comparison | IgnoreDate |
| New/existing files | TransferNewOnly and TransferMatchingOnly control whether only new files (i.e. ones not present on the target side) are displayed or whether only existing files (i.e. ones that exist on both sides) are displayed, respectively. By default both of these flags are off meaning that all files displayed. |
| File deletion | DeleteIfSourceAbsent controls whether or not files on the "target" side of the comparison will be deleted if they are not present on the "source" side. For example, if the transfer direction is set to upload and a file with a particular name is present on the server but there is no file with a matching name on the local machine then the suggested action will be to delete the file on the server. |
| Real-time updating | If RealTimeUpdate is true then FTPSynchronizeView will handle its FTP connection's directory-change events and automatically update its content in response. If it is false then the list will not be updated until RefreshList is called. |
| Hide files with no recommended action. | HideNoAction |
Customized file comparisons may be defined by handling the CompareFiles event, which will allow the developer to specify the match-text and the action using their own comparison algorithm.
All text that appears in FTPSynchronizeView may be modified through the properties of UserMessages and the sub-components exposed through LocalDirLabel, LocalDirTextBox, RemoteDirLabel, RemoteDirTextBox, DirectionButton and SynchronizeButton.
Namespace: EnterpriseDT.Net.Ftp.Forms
Assembly: edtFTPnetEx (in edtFTPnetEx.dll)
FTPSynchronizeView Members | EnterpriseDT.Net.Ftp.Forms Namespace