Downloads the specified remote file or directory to the local directory using multiple threads.
This method only downloads the items in the specified directory if the
remotePath parameter does not end with a directory separator (e.g. '/').
To also create the directory in the destination, add a directory separator character at the end of
that parameter.
public FileSystemTransferStatistics Download(
string remotePath,
string localPath,
TransferOptions options,
int threads,
bool waitForThreads
)
Public Function Download( _
ByVal remotePath As String, _
ByVal localPath As String, _
ByVal options As TransferOptions, _
ByVal threads As Integer, _
ByVal waitForThreads As Boolean _
) As FileSystemTransferStatistics
public:
FileSystemTransferStatistics Download(
String^ remotePath,
String^ localPath,
TransferOptions^ options,
int threads,
bool waitForThreads
);
Parameters
- remotePath
- The path and name of the remote directory where the files will be downloaded to the local folder.
This parameter can include filtering masks to limit the files that are downloaded. For example, if ""(empty string) is specified, the entire contents of the current folder will be downloaded.
If "*.txt" is used, all the files in the current folder that have the .TXT extension will be downloaded. If "/mydir/*.dat;*.cs,*.vb" is used (masks are delimited by ',', ';', and '|' characters), files with the DAT, CS, or VB extension in "/mydir" will be downloaded.
If no masks specified, the whole content of the remote directory should be downloaded. The final search condition depends on the SearchCondition and SearchConditionCombinedWithMasksInSourcePath settings of the options parameter.
If this value ends with a directory separator character like '/' or '\', the containing directory will also be downloaded. For example, if "/folder/" is used, files and subdirectories of "folder" directory and itself will be downloaded; the destination directory will contain "folder" directory and its contents.
Attention: some servers may be case-sensitive!
- localPath
- The path of the local directory to receive files from the server.
- options
- The transfer options object which provides many settings to control the file transfer process.
- threads
- The number of threads used for the simultaneous file transfer.
- waitForThreads
- A boolean value indicating whether to wait for the completion of all threads. If this parameter is true, this method blocks the caller process's execution until all threads have completed; otherwise, this method immediately returns the control to the caller process.
Return Value
A
FileSystemTransferStatistics object that contains transfer statictics and a list of processed files and directories.
Use 50 threads to download files simultaneously from the local disk.
using ComponentPro;
using ComponentPro.IO;
using ComponentPro.Net;
...
using (Ftp ftp = new Ftp())
{
// Connect to the FTP server.
ftp.Connect("localhost");
// Authenticate.
ftp.Authenticate("test", "test");
ftp.Download(
"/data", // The remote directory containing files and folders to download on the FTP server.
@"C:\dest", // The local directory.
new TransferOptions(),
50, // Use 50 threads
true // Wait until all the threads complete.
);
// Download DOC and IMG files only
ftp.Download(
"/data/*.doc;*.img", // The remote directory containing files and folders to download on the FTP server.
@"C:\dest", // The local directory.
new TransferOptions(),
50, // Use 50 threads
true // Wait until all the threads complete.
);
}
Imports ComponentPro
Imports ComponentPro.IO
Imports ComponentPro.Net
...
Using ftp As New Ftp()
' Connect to the FTP server.
ftp.Connect("localhost")
' Authenticate.
ftp.Authenticate("test", "test")
ftp.Download("/data", "C:\dest", New TransferOptions(), 50, True) ' Wait until all the threads complete. - Use 50 threads - The local directory. - The remote directory containing files and folders to download on the FTP server.
' Download DOC and IMG files only
ftp.Download("/data/*.doc;*.img", "C:\dest", New TransferOptions(), 50, True) ' Wait until all the threads complete. - Use 50 threads - The local directory. - The remote directory containing files and folders to download on the FTP server.
End Using