Name
FileSystemObject.BuildPath Method
Syntax
oFileSysObj
.BuildPath(Path
,Name
)
oFileSysObj
Use: Required
Data Type: FileSystemObject object
A FileSystemObject object.
Path
Use: Required
Data Type: String
A drive and/or folder path.
Name
Use: Required
Data Type: String
The folder or file path to append to
path
.
Return Value
A String.
Description
Creates a single string representing a path and filename or
simply a path by concatenating the path
parameter with the folder or filename, adding, where required, the
correct path separator for the host system.
Rules at a Glance
Path
can be an absolute or relative path and doesn’t have to include the drive name.Neither
Path
norName
has to currently exist.
Programming Tips and Gotchas
BuildPath is really a string concatenation method rather than a filesystem method; it does not check the validity of the new folder or filename. If you intend that the method’s return value be a path, you should check it by passing it to the FolderExists method; if you intend that the method’s return value be a path and filename, you should verify it by passing it to the FileExists method.
The only advantage to using the
BuildPath
function as opposed to concatenating two strings manually is that the function selects the correct path separator.
Get VBScript in a Nutshell, 2nd Edition now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.