Rename(String,String) Method

Renames file or directory on the server.

[Visual Basic]
Overloads Public Sub Rename( _
   ByVal NewRemotePath As String, _
   ByVal OldRemotePath As String _
) 

[C#]
public void Rename(
   string NewRemotePath,
   string OldRemotePath
);

[JScript]
public function Rename(
   NewRemotePath : String,
   OldRemotePath : String
);

Parameters

NewRemotePath

Full path to new file/directory name.

OldRemotePath

Full path to old file/directory name.

Remarks

This method will rename file or directory in remote server, if possible. Once completed, Done event will be fired. If no error occurs, Args.Error argument in Done event will be set to null (Nothing in VB). If error occurred, Args.Error will contain info about the error.

If you don't specify OldRemotePath argument, then wodFtpDLX.NET will use value of RemotePath property for this method.

Even UNIX (and windows in last few versions) have same command for renaming and moving (which is in fact MOVE command), you cannot be sure that this command will also move files from one directory to another. This depends only on server-side implementation of FTP and SFTP protocols.

No wildcards can be used for RemotePath argument. RFC protocol specifications for FTP and FTP do not allow them.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

FtpDLX Class  | FtpDLX Members  | Overload List

© WeOnlyDo Software. All Rights Reserved.