FileOverwriteMode Enumeration

Shows how to use Download method to download files and directories on an FTP server. The download process is controlled with handlers of the TransferConfirm and Progress events.

using System;
using ComponentPro.IO;
using ComponentPro.Net;

...

private static Ftp _client;
static void Main()
{
    // Create a new class instance. 
    Ftp client = new Ftp();
    _client = client;

    // Connect to the FTP server. 
    client.Connect("demo.componentpro.com");

    // Authenticate. 
    client.Authenticate("test", "test");

    // ... 
 
    client.TransferConfirm += client_TransferConfirm;
    client.Progress += client_Progress;

    try 
    {
        TransferOptions opt = new TransferOptions("*.*", FileOverwriteMode.Confirm);

        // Get all directories, subdirectories, and files in remote folder '/myfolder' to 'c:\myfolder'. 
        client.Download("/myfolder", "c:\\myfolder", opt);
    }
    catch (Exception exc)
    {
        Console.WriteLine("Error: " + exc.Message);
    }

    // ... 
 
    // Disconnect. 
    client.Disconnect();
}

/// <summary> 
/// This method is raised when user clicks on 'Cancel' button on the form. 
/// </summary> 
protected static void btnCancel_Click(object sender, EventArgs e)
{
    // Cancel the download operation when user clicks on the button. 
    _client.Cancel();
}

static void client_Progress(object sender, ComponentPro.IO.FileSystemProgressEventArgs e)
{
    // Show progress info. 
    Console.WriteLine("Current File: %{0} completed", e.Percentage);
    Console.WriteLine("Total: %{0} completed", e.TotalPercentage);

    switch (e.State)
    {
        case TransferState.StartDownloadingFile:
            if (e.SourcePath.EndsWith(".exe"))
            {
                // Skip all .exe files 
                e.Skip = true;
            }
            else if (e.SourcePath.StartsWith("/MyFolder"))
            {
                // Change the source file path if it starts with "/MyFolder" 
                e.SourcePath = e.SourcePath.Replace("/MyFolder", "/MySecondFolder");
            }
            break;
    }
}

static void client_TransferConfirm(object sender, ComponentPro.IO.TransferConfirmEventArgs e)
{
    if (e.Exception != null)
        Console.WriteLine("Error: " + e.Exception.Message);

    if (e.ConfirmReason == TransferConfirmReason.FileAlreadyExists)
    {
        // Skip the existing file. 
        e.NextAction = TransferConfirmNextActions.Skip;
    }

    Console.Write("Do you want to (r)etry or (s)kip?");
    string key = Console.ReadLine();
    if (key == "r")
        e.NextAction = TransferConfirmNextActions.Retry;
    else if (key == "s")
        e.NextAction = TransferConfirmNextActions.Skip;
    else 
        // Cancel the operation. 
        e.NextAction = TransferConfirmNextActions.Cancel;
}

Imports ComponentPro.IO
Imports ComponentPro.Net

...

Private Shared _client As Ftp
Shared Sub Main()
    ' Create a new class instance. 
    Dim client As New Ftp()
    _client = client

    ' Connect to the FTP server. 
    client.Connect("demo.componentpro.com")

    ' Authenticate. 
    client.Authenticate("test", "test")

    ' ... 
 
    AddHandler client.TransferConfirm, AddressOf client_TransferConfirm
    AddHandler client.Progress, AddressOf client_Progress

    Try 
        Dim opt As New TransferOptions("*.*", FileOverwriteMode.Confirm)

        ' Get all directories, subdirectories, and files in remote folder '/myfolder' to 'c:\myfolder'. 
        client.Download("/myfolder", "c:\myfolder", opt)
    Catch exc As Exception
        Console.WriteLine("Error: " & exc.Message)
    End Try 
 
    ' ... 
 
    ' Disconnect. 
    client.Disconnect()
End Sub 
 
''' <summary> 
''' This method is raised when user clicks on 'Cancel' button on the form. 
''' </summary> 
Protected Shared Sub btnCancel_Click(ByVal sender As Object, ByVal e As EventArgs)
    ' Cancel the download operation when user clicks on the button. 
    _client.Cancel()
End Sub 
 
Private Shared Sub client_Progress(ByVal sender As Object, ByVal e As ComponentPro.IO.FileSystemProgressEventArgs)
    ' Show progress info. 
    Console.WriteLine("Current File: %{0} completed", e.Percentage)
    Console.WriteLine("Total: %{0} completed", e.TotalPercentage)

    Select Case e.State
        Case TransferState.StartDownloadingFile
            If e.SourcePath.EndsWith(".exe") Then 
                ' Skip all .exe files 
                e.Skip = True 
            ElseIf e.SourcePath.StartsWith("/MyFolder") Then 
                ' Change the source file path if it starts with "/MyFolder" 
                e.SourcePath = e.SourcePath.Replace("/MyFolder", "/MySecondFolder")
            End If 
    End Select 
End Sub 
 
Private Shared Sub client_TransferConfirm(ByVal sender As Object, ByVal e As ComponentPro.IO.TransferConfirmEventArgs)
    If e.Exception IsNot Nothing Then 
        Console.WriteLine("Error: " & e.Exception.Message)
    End If 
 
    If e.ConfirmReason = TransferConfirmReason.FileAlreadyExists Then 
        ' Skip the existing file. 
        e.NextAction = TransferConfirmNextActions.Skip
    End If 
 
    Console.Write("Do you want to (r)etry or (s)kip?")
    Dim key As String = Console.ReadLine()
    If key = "r" Then 
        e.NextAction = TransferConfirmNextActions.Retry
    ElseIf key = "s" Then 
        e.NextAction = TransferConfirmNextActions.Skip
    Else 
        ' Cancel the operation. 
        e.NextAction = TransferConfirmNextActions.Cancel
    End If 
End Sub

Shows how to use Upload methods to upload files. The system will skip existing files on the server.

using System;
using ComponentPro.IO;
using ComponentPro.Net;

...

public void DoUpload()
{
    // Create a new class instance. 
    Sftp client = new Sftp();

    // Connect to the SFTP server. 
    client.Connect("demo.componentpro.com");

    // Authenticate. 
    client.Authenticate("test", "test");

    // ... 
 
    client.TransferConfirm += client_TransferConfirm;
    client.Progress += client_Progress;

    try 
    {
        TransferOptions opt = new TransferOptions("*.*", FileOverwriteMode.Confirm);

        // Get all directories, subdirectories, and files in local folder 'c:\myfolder' to remote folder '/myfolder'. 
        client.Upload("c:\\myfolder", "/myfolder", opt);
    }
    catch (Exception exc)
    {
        Console.WriteLine("Error: " + exc.Message);
    }

    // ... 
 
    // Disconnect. 
    client.Disconnect();
}

void client_Progress(object sender, ComponentPro.IO.FileSystemProgressEventArgs e)
{
    // Show progress info. 
    Console.WriteLine("Current File: %{0} completed", e.Percentage);
    Console.WriteLine("Total: %{0} completed", e.TotalPercentage);

    switch (e.State)
    {
        case TransferState.StartUploadingFile:
            if (e.SourcePath.EndsWith(".exe"))
            {
                // Skip all .exe files 
                e.Skip = true;  
            }
            else if (e.SourcePath.StartsWith(@"C:\MyFolder"))
            {
                // Change the source file path if it starts with "C:\MyFolder" 
                e.SourcePath = e.SourcePath.Replace(@"C:\MyFolder", @"C:\MySecondFolder");
            }
            break;
    }
}

void client_TransferConfirm(object sender, ComponentPro.IO.TransferConfirmEventArgs e)
{
    if (e.Exception != null)
        Console.WriteLine("Error: " + e.Exception.Message);

    if (e.ConfirmReason == TransferConfirmReason.FileAlreadyExists)
    {
        // Skip the existing file. 
        e.NextAction = TransferConfirmNextActions.Skip;
    }

    Console.Write("Do you want to (r)etry or (s)kip?");
    string key = Console.ReadLine();
    if (key == "r")
        e.NextAction = TransferConfirmNextActions.Retry;
    else if (key == "s")
        e.NextAction = TransferConfirmNextActions.Skip;
    else 
        // Cancel the operation. 
        e.NextAction = TransferConfirmNextActions.Cancel;
}

Imports ComponentPro.IO
Imports ComponentPro.Net

...

Public Sub DoUpload()
    ' Create a new class instance. 
    Dim client As New Sftp()

    ' Connect to the SFTP server. 
    client.Connect("demo.componentpro.com")

    ' Authenticate. 
    client.Authenticate("test", "test")

    ' ... 
 
    AddHandler client.TransferConfirm, AddressOf client_TransferConfirm
    AddHandler client.Progress, AddressOf client_Progress

    Try 
        Dim opt As New TransferOptions("*.*", FileOverwriteMode.Confirm)

        ' Get all directories, subdirectories, and files in local folder 'c:\myfolder' to remote folder '/myfolder'. 
        client.Upload("c:\myfolder", "/myfolder", opt)
    Catch exc As Exception
        Console.WriteLine("Error: " & exc.Message)
    End Try 
 
    ' ... 
 
    ' Disconnect. 
    client.Disconnect()
End Sub 
 
Private Sub client_Progress(ByVal sender As Object, ByVal e As ComponentPro.IO.FileSystemProgressEventArgs)
    ' Show progress info. 
    Console.WriteLine("Current File: %{0} completed", e.Percentage)
    Console.WriteLine("Total: %{0} completed", e.TotalPercentage)

    Select Case e.State
        Case TransferState.StartUploadingFile
            If e.SourcePath.EndsWith(".exe") Then 
                ' Skip all .exe files 
                e.Skip = True 
            ElseIf e.SourcePath.StartsWith("C:\MyFolder") Then 
                ' Change the source file path if it starts with "C:\MyFolder" 
                e.SourcePath = e.SourcePath.Replace("C:\MyFolder", "C:\MySecondFolder")
            End If 
    End Select 
End Sub 
 
Private Sub client_TransferConfirm(ByVal sender As Object, ByVal e As ComponentPro.IO.TransferConfirmEventArgs)
    If e.Exception IsNot Nothing Then 
        Console.WriteLine("Error: " & e.Exception.Message)
    End If 
 
    If e.ConfirmReason = TransferConfirmReason.FileAlreadyExists Then 
        ' Skip the existing file. 
        e.NextAction = TransferConfirmNextActions.Skip
    End If 
 
    Console.Write("Do you want to (r)etry or (s)kip?")
    Dim key As String = Console.ReadLine()
    If key = "r" Then 
        e.NextAction = TransferConfirmNextActions.Retry
    ElseIf key = "s" Then 
        e.NextAction = TransferConfirmNextActions.Skip
    Else 
        ' Cancel the operation. 
        e.NextAction = TransferConfirmNextActions.Cancel
    End If 
End Sub

Shows how to use AddFiles methods to upload files. The system will skip existing files on the server.

using System;
using ComponentPro.IO;
using ComponentPro.Compression;

...

private Zip _zip;
public void DoUpload()
{
    // Create a new instance. 
    Zip zip = new Zip();
    _zip = zip;

    // Create a new archive. 
    zip.Create("test.zip");

    // ... 
 
    zip.TransferConfirm += zip_TransferConfirm;
    zip.Progress += zip_Progress;

    try 
    {
        TransferOptions opt = new TransferOptions("*.*", FileOverwriteMode.Confirm);

        // Add all directories, subdirectories, and files in local folder 'c:\myfolder' to remote folder '/myfolder'. 
        zip.AddFiles("c:\\myfolder", "/myfolder", opt);
    }
    catch (Exception exc)
    {
        Console.WriteLine("Error: " + exc.Message);
    }

    // ... 
 
    // Close. 
    zip.Close();
}

/// <summary> 
/// This method is raised when user clicks on 'Cancel' button on the form. 
/// </summary> 
protected void btnCancel_Click(object sender, EventArgs e)
{
    // Cancel the upload operation when user clicks on the button. 
    _zip.Cancel();
}

void zip_Progress(object sender, ComponentPro.IO.FileSystemProgressEventArgs e)
{
    // Show progress info. 
    Console.WriteLine("Current File: %{0} completed", e.Percentage);
    Console.WriteLine("Total: %{0} completed", e.TotalPercentage);

    switch (e.State)
    {
        case TransferState.StartStoringFile:
            if (e.SourcePath.EndsWith(".exe"))
            {
                // Skip all .exe files 
                e.Skip = true;
            }
            else if (e.SourcePath.StartsWith(@"C:\MyFolder"))
            {
                // Change the source file path if it starts with "C:\MyFolder" 
                e.SourcePath = e.SourcePath.Replace(@"C:\MyFolder", @"C:\MySecondFolder");
            }
            break;
    }
}

void zip_TransferConfirm(object sender, ComponentPro.IO.TransferConfirmEventArgs e)
{
    if (e.Exception != null)
        Console.WriteLine("Error: " + e.Exception.Message);

    if (e.ConfirmReason == TransferConfirmReason.FileAlreadyExists)
    {
        // Skip the existing file. 
        e.NextAction = TransferConfirmNextActions.Skip;
    }

    Console.Write("Do you want to (r)etry or (s)kip?");
    string key = Console.ReadLine();
    if (key == "r")
        e.NextAction = TransferConfirmNextActions.Retry;
    else if (key == "s")
        e.NextAction = TransferConfirmNextActions.Skip;
    else 
        // Cancel the operation. 
        e.NextAction = TransferConfirmNextActions.Cancel;
}

Imports ComponentPro.IO
Imports ComponentPro.Compression

...

Private _zip As Zip
Public Sub DoUpload()
    ' Create a new instance. 
    Dim zip As New Zip()
    _zip = zip

    ' Create a new archive. 
    zip.Create("test.zip")

    ' ... 
 
    AddHandler zip.TransferConfirm, AddressOf zip_TransferConfirm
    AddHandler zip.Progress, AddressOf zip_Progress

    Try 
        Dim opt As New TransferOptions("*.*", FileOverwriteMode.Confirm)

        ' Add all directories, subdirectories, and files in local folder 'c:\myfolder' to remote folder '/myfolder'. 
        zip.AddFiles("c:\myfolder", "/myfolder", opt)
    Catch exc As Exception
        Console.WriteLine("Error: " & exc.Message)
    End Try 
 
    ' ... 
 
    ' Close. 
    zip.Close()
End Sub 
 
''' <summary> 
''' This method is raised when user clicks on 'Cancel' button on the form. 
''' </summary> 
Protected Sub btnCancel_Click(ByVal sender As Object, ByVal e As EventArgs)
    ' Cancel the upload operation when user clicks on the button. 
    _zip.Cancel()
End Sub 
 
Private Sub zip_Progress(ByVal sender As Object, ByVal e As ComponentPro.IO.FileSystemProgressEventArgs)
    ' Show progress info. 
    Console.WriteLine("Current File: %{0} completed", e.Percentage)
    Console.WriteLine("Total: %{0} completed", e.TotalPercentage)

    Select Case e.State
        Case TransferState.StartStoringFile
            If e.SourcePath.EndsWith(".exe") Then 
                ' Skip all .exe files 
                e.Skip = True 
            ElseIf e.SourcePath.StartsWith("C:\MyFolder") Then 
                ' Change the source file path if it starts with "C:\MyFolder" 
                e.SourcePath = e.SourcePath.Replace("C:\MyFolder", "C:\MySecondFolder")
            End If 
    End Select 
End Sub 
 
Private Sub zip_TransferConfirm(ByVal sender As Object, ByVal e As ComponentPro.IO.TransferConfirmEventArgs)
    If e.Exception IsNot Nothing Then 
        Console.WriteLine("Error: " & e.Exception.Message)
    End If 
 
    If e.ConfirmReason = TransferConfirmReason.FileAlreadyExists Then 
        ' Skip the existing file. 
        e.NextAction = TransferConfirmNextActions.Skip
    End If 
 
    Console.Write("Do you want to (r)etry or (s)kip?")
    Dim key As String = Console.ReadLine()
    If key = "r" Then 
        e.NextAction = TransferConfirmNextActions.Retry
    ElseIf key = "s" Then 
        e.NextAction = TransferConfirmNextActions.Skip
    Else 
        ' Cancel the operation. 
        e.NextAction = TransferConfirmNextActions.Cancel
    End If 
End Sub