File System Task

The File System task performs operations on files and directories in the file system. For example, by using the File System task, a package can create, move, or delete directories and files. You can also use the File System task to set attributes on files and directories. For example, the File System task can make files hidden or read-only.

All File System task operations use a source, which can be a file or a directory. For example, the file that the task copies or the directory it deletes is a source. The source can be specified by using a File connection manager that points to the directory or file or by providing the name of a variable that contains the source path. For more information, see File Connection Manager and Integration Services Variables.

The operations that copy and move file and directories and rename files use a destination and a source. The destination is specified by using a File connection manager or a variable. File system task operations can be configured to permit overwriting of destination files and directories. The operation that creates a new directory can be configured to use an existing directory that has the specified name instead of failing when the directory already exists.

Predefined File System Operations

The File System task includes a predefined set of operations. The following table describes these operations.

The File System task operates on a single file or directory. Therefore, this task does not support the use of wildcard characters to perform the same operation on multiple files. To have the File System task repeat an operation on multiple files or directories, put the File System task in a Foreach Loop container, as described in the following steps:

• Configure the Foreach Loop container   On the Collection page of the Foreach Loop Editor, set the enumerator to Foreach File Enumerator and enter the wildcard expression as the enumerator configuration for Files. On the Variable Mappings page of the Foreach Loop Editor, map a variable that you want to use to pass the file names one at a time to the File System task.
• Add and configure a File System task   Add a File System task to the Foreach Loop container. On the General page of the File System Task Editor, set the SourceVariable or DestinationVariable property to the variable that you defined in the Foreach Loop container.

Other Related Tasks

Integration Services includes a task that downloads and uploads data files and manages directories on servers.

For more information about this task, click the following topic:

• FTP Task

Custom Log Entries Available on the File System Task

The following table describes the custom log entry for the File System task. For more information, see Implementing Logging in Packages and Custom Messages for Logging.

Configuring the File System Task

You can set properties through SSIS Designer or programmatically.

For more information about the properties that you can set in SSIS Designer, click one of the following topics:

• File System Task Editor (General Page)
• Expressions Page

For more information about how to set these properties in SSIS Designer, click the following topic:

• How to: Set Task Properties

Configuring the File System Task Programmatically

For more information about programmatically setting these properties, click one of the following topics:

• FileSystemTask

See Also

Concepts

Integration Services Tasks
Creating Package Control Flow

Help and Information

Getting SQL Server 2005 Assistance

Change History