DotFTP 3.0.2

DotFTP.NETStandard

DotFTP è una libreria per gestire i seguenti protocolli:

• FTP
• FTPS
• SFTP
• SCP

consentendo di eseguire le operazioni più comuni quali Upload, Download, Delete e consultazione dei file su host remoto.

Piattaforme supportate

DotFTP ha come target .NET Standard 2.0 ed è quindi compatibile con:

Librerie utilizzate

DotFTP utilizza le librerie open source FluentFTP per FTP, FTPS e SSH.NET per FTPS e SCP

Esempi di utilizzo

DotFTP è molto semplice da utilizzare. Gli esempi riportati si riferiscono all'implementazione dell'interfaccia per FTP/FTPS ma sono sostanzialmente identici per SFTP e SCP. Sarà sufficiente inizializzare l'interfaccia utilizzando SFtpClient e ScpClient rispettivamente

Lettura file nella directory root

using (IFtpClient client = new FtpClient("localhost", "username", "Password"))
{
    try
    {
        client.Connect();
        List<string> files = client.GetFileList("/");
        Console.WriteLine("Elenco file: ");
        foreach (string file in files)
            Console.WriteLine(file);
    }
    catch (Exception ex)
    { Console.WriteLine(ex.Message); }
}

Upload di un file nella cartella /folder

using (IFtpClient client = new FtpClient("localhost", "username", "Password"))
{
    try
    {
        client.Connect();
        client.UploadFile("/folder", @"C:\tmp\DotFTP", "upload.txt");
    }
    catch (Exception ex)
    { Console.WriteLine(ex.Message); }
}

Download di un file da /folder

using (IFtpClient client = new FtpClient("localhost", "username", "Password"))
{
    try
    {
        client.Connect();
        client.DownloadFile("/folder", "upload.txt", @"C:\tmp\DotFTP");
    }
    catch (Exception ex)
    { Console.WriteLine(ex.Message); }
}

Migrazione da IFTPAgent

La migrazione da IFTPAgent a IFtpClient è molto semplice. I metodi hanno mantenuto lo stesso nome e sono semplicemente stati rimossi i parametri host, port, user e pass e quelli rimasti hanno lo stesso ordine e modalità di funzionamento.

Questo è un esempio di come convertire il download di un file:

//Implementazione con IFTPAgent: 
IFTPAgent ftpAgent = new FTPAgent();
    ftpAgent.DownloadFile("localhost", 21, "/", "upload.txt", @"C:\tmp\DotFTP", "username", "Password");

//Implementazione con IFtpClient:
using (IFtpClient client = new FtpClient("localhost", "username", "Password", 21))
{
    try
    {
        client.Connect();
        client.DownloadFile("/folder", "upload.txt", @"C:\tmp\DotFTP");
    }
    catch (Exception ex)
    { Console.WriteLine(ex.Message); }
}

Consigli pratici

1. L'host può essere specificato sia con il protocollo che senza, quindi è valido sia sftp://serverdomain.com che serverdomain.com
2. Il path del server FTP deve essere assoluto, quindi partendo dalla root /