FileSystemEventArgs 類別

定義

命名空間:

System.IO

組件:

System.IO.FileSystem.Watcher.dll

來源:

FileSystemEventArgs.cs

提供資料給目錄事件：Changed、Created、Deleted。

C#

public class FileSystemEventArgs : EventArgs

繼承

Object

EventArgs

FileSystemEventArgs

衍生

System.IO.RenamedEventArgs

範例

下列範例示範如何建立 FileSystemWatcher ，以監視磁碟驅動器上 (建立、刪除、重新命名、變更) 的檔案變更。 此範例也會示範如何正確接收錯誤通知。

C#

using System;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        //  Create a FileSystemWatcher to monitor all files on drive C.
        FileSystemWatcher fsw = new FileSystemWatcher("C:\\");

        //  Watch for changes in LastAccess and LastWrite times, and
        //  the renaming of files or directories.
        fsw.NotifyFilter = NotifyFilters.LastAccess | NotifyFilters.LastWrite
            | NotifyFilters.FileName |NotifyFilters.DirectoryName;

        //  Register a handler that gets called when a
        //  file is created, changed, or deleted.
        fsw.Changed += new FileSystemEventHandler(OnChanged);

        fsw.Created += new FileSystemEventHandler(OnChanged);

        fsw.Deleted += new FileSystemEventHandler(OnChanged);

        //  Register a handler that gets called when a file is renamed.
        fsw.Renamed += new RenamedEventHandler(OnRenamed);

        //  Register a handler that gets called if the
        //  FileSystemWatcher needs to report an error.
        fsw.Error += new ErrorEventHandler(OnError);

        //  Begin watching.
        fsw.EnableRaisingEvents = true;

        Console.WriteLine("Press \'Enter\' to quit the sample.");
        Console.ReadLine();
    }

    //  This method is called when a file is created, changed, or deleted.
    private static void OnChanged(object source, FileSystemEventArgs e)
    {
        //  Show that a file has been created, changed, or deleted.
        WatcherChangeTypes wct = e.ChangeType;
        Console.WriteLine("File {0} {1}", e.FullPath, wct.ToString());
    }

    //  This method is called when a file is renamed.
    private static void OnRenamed(object source, RenamedEventArgs e)
    {
        //  Show that a file has been renamed.
        WatcherChangeTypes wct = e.ChangeType;
        Console.WriteLine("File {0} {2} to {1}", e.OldFullPath, e.FullPath, wct.ToString());
    }

    //  This method is called when the FileSystemWatcher detects an error.
    private static void OnError(object source, ErrorEventArgs e)
    {
        //  Show that an error has been detected.
        Console.WriteLine("The FileSystemWatcher has detected an error");
        //  Give more information if the error is due to an internal buffer overflow.
        if (e.GetException().GetType() == typeof(InternalBufferOverflowException))
        {
            //  This can happen if Windows is reporting many file system events quickly
            //  and internal buffer of the  FileSystemWatcher is not large enough to handle this
            //  rate of events. The InternalBufferOverflowException error informs the application
            //  that some of the file system events are being lost.
            Console.WriteLine(("The file system watcher experienced an internal buffer overflow: " + e.GetException().Message));
        }
    }
}

備註

類別 FileSystemEventArgs 會當做參數傳遞至這些事件的事件處理程式：

• 變更Changed大小、系統屬性、上次寫入時間、上次存取時間，或檔案或目錄中PathFileSystemWatcher指定的安全性許可權時，就會發生此事件。

• 建立 指定 之 PathFileSystemWatcher 中的檔案或目錄時，就會發生此Created事件。

• 刪除指定 PathFileSystemWatcher 之 中的檔案或目錄時，就會發生此Deleted事件。 如需詳細資訊，請參閱FileSystemWatcher。

建構函式

FileSystemEventArgs(WatcherChangeTypes, String, String)

初始化 FileSystemEventArgs 類別的新執行個體。

屬性

ChangeType	取得發生的目錄事件型別。
FullPath	取得受影響檔案或目錄的完整路徑。
Name	取得受影響檔案或目錄的名稱。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

適用於

另請參閱

• Changed
• Created
• Deleted
• FileSystemEventHandler
• FileSystemWatcher
• InternalBufferOverflowException
• NotifyFilters
• OnCreated(FileSystemEventArgs)
• OnDeleted(FileSystemEventArgs)
• Path
• RenamedEventArgs
• RenamedEventHandler
• WaitForChangedResult
• WatcherChangeTypes