C# 5.0 Programmer's Reference

434 ❘ CHAPTER 19 File System Objects
(continued)
Property or Method
MoveTo
Name
Open
OpenRead
OpenText
OpenWrite
Refresh
Replace
ToString
Purpose
Moves the file to a new location. If the destination uses a relative path,
it is relative to the application’s current directory, not to the FileInfo
object’s directory. When this method finishes, the FileInfo object is
updated to refer to the file’s new location.
The file’s name without the path information.
Opens the file with various mode (Append, Create, CreateNew, Open,
OpenOrCreate, or Truncate), access (Read, Write, or ReadWrite),
and sharing (Read, Write, ReadWrite, or None) settings. This method
returns a FileStream object attached to the file.
Returns a read-only FileStream attached to the file.
Returns a StreamReader with UTF-8 encoding attached to the file
for reading.
Returns a write-only FileStream attached to the file.
Refreshes the FileInfo object’s data.
Takes three file paths as parameters, representing a source file,
a destination file, and a backup file. If the backup file exists, this
method permanently deletes it. It then moves the destination file to
the backup file, and moves the source file to the destination file.
Returns the file’s fully qualified name.
FileSystemWatcher
The FileSystemWatcher class keeps an eye on part of the file system and raises events to let your
program know if something changes. For example, a FileSystemWatcher can monitor a directory
and raise an event when a new file appears so your program can process the file.
The FileSystemWatcher class’s constructor takes parameters that tell it which directory to watch
and that give it a filter for selecting files to watch. For example, the filter *.txt makes it watch for
changes to text files. The default filter is *.*, which catches changes to all files that have extensions.
The following table describes the FileSystemWatcher class’s most useful properties.
Property
EnableRaisingEvents
Purpose
Determines whether the watcher is enabled. (This property is
false by default, so the watcher does not raise any events until
you set it to true.)
www.it-ebooks.info