Click or drag to resize

FileSpec.FullPath Property (Typed)

X#
A string representing the full path name defined to this file specification.

Namespace:  XSharp.VO.SDK
Assembly:  XSharp.VOSystemClasses (in XSharp.VOSystemClasses.dll) Version: 2.21
Syntax
Copy
 VIRTUAL PROPERTY FullPath AS STRING GET SET
Request Example View Source

Property Value

Type: String
A string representing the full path name defined to this file specification.
Remarks
A string representing the full path name defined to this file specification. The individual components of the full path name may have been assigned explicitly or as part of a longer file specification (assigned either as an instantiation parameter or as part of a file name or full path assignment). When accessing FileSpec:FullPath, the requested path name is returned with drive, path, file name, and extension. However, if the file was not fully specified and the file has not been found since, parts of the path can be unknown. Any part that is not known is omitted from the return value. When assigning FileSpec:FullPath, you can specify a simple file name, a file name with an extension, or a full path complete with drive. The information given is parsed and assigned to the appropriate components; in addition, when assigning a string to FileSpec:FullPath, those parts that are omitted in the string are stored as unknown or unspecified.
Tip Tip
FileSpec does not distinguish between a file with no extension and a subdirectory (e.g., C:\CAVOxx, in which the directory "CAVOxx" appears to be a file with no extension).
Examples
Here are some examples of strings that are returned by FileSpec:FullPath, with an explanation of what they indicate:
X#
Copy
 1// All known
 2c:\data\customer\custdata.dbf
 3// Drive unknown
 4\data\customer\custdata.dbf
 5// Path is ROOT
 6c:\custdata.dbf
 7// Drive and path unknown
 8custdata.dbf
 9// Drive unknown, path is ROOT
10\custdata.dbf
11// Extension unknown
12c:\data\customer\custdata
13// Only file name is known
14custdata
Here are some examples of assigning strings to FileSpec:FullPath, with an explanation of the results:
X#
Copy
 1// Assign and display FileSpec:FullPath
 2oFS:FileSpec := ("String")
 3? oFS:FullPath
 4// All but file name marked unknown
 5oFS:FullPath := "cust"
 6// All but file name and extension marked unknown
 7oFS:FullPath:= "cust.dbx"
 8// Sets path and file name, marks drive and
 9// extension as unknown
10oFS:FullPath := "data\cust"
11// Same thing
12oFS:FullPath := "\data\cust"
13// Changes drive, path, file name;
14// sets extension unknown
15oFS:FullPath := "d:cust"
See Also