FileSpec.Rename Method

Rename the file represented by this file specification.

Namespace: VO
Assembly: VOSystemClasses (in VOSystemClasses.dll) Version: 2.21

Syntax

 VIRTUAL METHOD Rename(
	oFSTarget,
	lName
) AS USUAL CLIPPER

[ClipperCallingConventionAttribute(new string[] { ... })]
public virtual Usual Rename(
	Usual oFSTarget = default,
	Usual lName = default
)

oFSTarget (Optional): Type: Usual
The new file name.
lName (Optional): Type: Usual
Make a different file name if conflict exist. The new name will start with the base file name of the original file. 8 character file name with 5 or 6 chars of original name plus a suffix ranging from "_1" to "_99" if a name conflict occurs. Otherwise returns NULL_STRING

Type: Usual
TRUE if the file was successfully renamed; otherwise, FALSE.

Examples

The following examples renames a file:

1oFSSource := FileSpec{"c =:\data\customer.dbf"}
2// Rename the file
3oFSSource:Rename("customer.bak")