Session.ListDirectory Method

Lists the contents of specified remote directory.

This feature is available only in the latest beta release.

Syntax
- Parameters
- Return Value
Exceptions
Example

Syntax

public RemoteDirectoryInfo ListDirectory(string path)

Parameters

Name	Description
string path	Full path to remote directory to be read.

Return Value

RemoteDirectoryInfo.

Exceptions

Exception	Condition
InvalidOperationException	Session is not opened.
SessionLocalException	Error communicating with `winscp.com`. See the exception documentation for details.
SessionRemoteException	Session has failed. Listing of remote directory has failed. See the exception documentation for details.
TimeoutException	Timeout waiting for `winscp.com` to respond.

Example

using System;
using System.Collections.ObjectModel;
using WinSCP;
 
class Example
{
    public static int Main()
    {
        try
        {
            // Setup session options
            SessionOptions sessionOptions = new SessionOptions();
            sessionOptions.Protocol = Protocol.Sftp;
            sessionOptions.HostName = "example.com";
            sessionOptions.UserName = "user";
            sessionOptions.Password = "mypassword";
            sessionOptions.SshHostKey = "ssh-rsa 1024 xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx";
 
            using (Session session = new Session())
            {
                // Connect
                session.Open(sessionOptions);
 
                RemoteDirectoryInfo directory = session.ListDirectory("/home/martin/public_html");
 
                foreach (RemoteFileInfo fileInfo in directory.Files)
                {
                    Console.WriteLine("{0} with size {1}, permissions {2} and last modification at {3}",
                        fileInfo.Name, fileInfo.Length, fileInfo.FilePermissions, fileInfo.LastWriteTime);
                }
            }
 
            return 0;   
        }
        catch (Exception e)
        {
            Console.WriteLine("Error: {0}", e);
            return 1;
        }
    }
}

Session.ListDirectory Method

Syntax

Parameters

Return Value

Exceptions

Example

Documentation

Support

Associations

Follow Us