Copies a file or folder on disk to another disk location. If you copy a folder, this node copies all the contents of the folder recursively to the new location.
Custom message that appears in the title bar of the file dialog box that appears when you do not wire a target path input.
The absolute path to the file or folder on which you want to operate. If you do not wire a value to path, this node displays a dialog box from which you can select a file or folder. If you specify an empty or relative path, this node returns an error
The new absolute path for the file or folder, including the new file or folder name.
This node does not automatically append file extensions, such as .txt, to filenames when it copies or moves files. You must explicitly include the extension as a part of the new filename that you specify in target path.
If target path is unwired, the node displays a dialog box from which to select a file or folder. This node behaves differently according to the file or directory you specify in target path.
File or Directory Type | Behavior |
---|---|
Existing file | Returns a Duplicate Path error. |
Existing directory | Places the new file or directory inside the existing directory using the original file or directory name. |
Invalid, empty, or relative path | Returns an error. |
Gaining Write Permission for a Specified File or Directory
A Boolean value that determines whether the node replaces existing files or folders in the target path that have the same names as files or folders in the source path.
True | This node replaces existing files or folders in the target path. If you overwrite a folder that contains unique files, this node moves those files in the new folder. This node does not overwrite read-only files, even if you set this input to True. |
False | This node keeps the existing files or folders in the target path. |
Error conditions that occur before this node runs.
The node responds to this input according to standard error behavior.
Standard Error Behavior
Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.
Default: No error
New location of the file or directory. If the operation is unsuccessful, this output returns <Not A Path>.
Error information.
The node produces this output according to standard error behavior.
Standard Error Behavior
Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.
If you copy the directory c:\app to d:\app2, the node creates a new directory d:\app2 with the same contents as c:\app. The second time you copy the directory, the node creates a new subdirectory d:\app2\app and places the contents of app there. The third time you copy the directory, the node returns a Duplicate Path error.
Where This Node Can Run:
Desktop OS: Windows
FPGA: Not supported
Web Server: Not supported in VIs that run in a web application