Xceed .NET Libraries Documentation
Xceed.Ftp Assembly / Xceed.Ftp Namespace / FtpClient Class / ChangeCurrentFolder Method
The new current working folder. Some FTP servers may be case-sensitive!


In This Topic
    ChangeCurrentFolder Method
    In This Topic
    Changes the current working folder of the FTP server.
    Syntax
    'Declaration
     
    Public Sub ChangeCurrentFolder( _
       ByVal folder As String _
    ) 
    'Usage
     
    Dim instance As FtpClient
    Dim folder As String
     
    instance.ChangeCurrentFolder(folder)
    public void ChangeCurrentFolder( 
       string folder
    )

    Parameters

    folder
    The new current working folder. Some FTP servers may be case-sensitive!
    Exceptions
    ExceptionDescription
    Cannot perform the requested operation because the FTP client is in an invalid state.
    An error reply was returned by the FTP server.
    An I/O error has occurred.
    A fatal FTP-specific error has occurred..
    Remarks

    Both relative and absolute paths can be provided to the ChangeCurrentFolder method to change the FTP server's current working folder, however some FTP servers might not support absolute paths and different server types may have different ways of representing absolute paths.

    The FTP server's current working folder is used by the FTP server as the base folder from which to perform file operations such as obtaining folder contents, receiving, sending and deleting files, changing the current folder, etc.

    The ChangeToParentFolder method should be used in the case where you want the parent folder to be the new current working folder.

    The current working folder can be retrieved via the GetCurrentFolder method.

    The ChangeCurrentFolder method will send the CWD command to the FTP server.

    Requirements

    Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

    See Also

    Reference

    FtpClient Class
    FtpClient Members
    ChangeToParentFolder Method
    Xceed.Ftp.FtpClient.GetCurrentFolder(Xceed.Ftp.Engine.FtpCommandChannel,Xceed.Ftp.Engine.CurrentFolderFtpCommand)