Xceed .NET Libraries Documentation
ChangeCurrentFolder Method


Xceed.Ftp Assembly > Xceed.Ftp Namespace > FtpClient Class : ChangeCurrentFolder Method
The new current working folder. Some FTP servers may be case-sensitive!
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)