FileSystemWatcher.EnableRaisingEvents プロパティ

[アーティクル]
03/28/2008

コンポーネントが有効かどうかを示す値を取得または設定します。

Public Property EnableRaisingEvents As Boolean
[C#]
public bool EnableRaisingEvents {get; set;}
[C++]
public: __property bool get_EnableRaisingEvents();public: __property void set_EnableRaisingEvents(bool);
[JScript]
public function get EnableRaisingEvents() : Boolean;public function set EnableRaisingEvents(Boolean);

プロパティ値

コンポーネントが有効な場合は true 。それ以外の場合は false 。既定値は false です。Visual Studio .NET のデザイナでコンポーネントを使用している場合、既定値は true です。

解説

コンポーネントは EnableRaisingEvents を true に設定しない限りイベントを発生させません。

メモコンポーネントは、 Path プロパティが設定され、 EnableRaisingEvents が true になるまで指定したディレクトリをウォッチしません。

使用例

[Visual Basic, C#, C++] 実行時に指定したディレクトリをウォッチする FileSystemWatcher を作成する例を次に示します。コンポーネントは、ディレクトリのテキストファイルの LastWrite 時刻と LastAccess 時刻の変更、それらのファイルの作成、削除、名前の変更をウォッチするように設定されます。ファイルが変更、作成、または削除されると、そのファイルのパスがコンソールに表示されます。ファイルの名前を変更する場合は、古いパスと新しいパスがコンソールに出力されます。

[Visual Basic, C#, C++] この例では、 System.Diagnostics 名前空間と System.IO 名前空間を使用します。

 
Public Class Watcher
    
    Public Shared Sub Main()
        Dim args() As String = System.Environment.GetCommandLineArgs()
        ' If a directory is not specified, exit the program.
        If args.Length <> 2 Then
            ' Display the proper way to call the program.
            Console.WriteLine("Usage: Watcher.exe (directory)")
            Return
        End If
        
        ' Create a new FileSystemWatcher and set its properties.
        Dim watcher As New FileSystemWatcher()
        watcher.Path = args(1)
        ' Watch for changes in LastAccess and LastWrite times, and
        ' the renaming of files or directories. 
        watcher.NotifyFilter = (NotifyFilters.LastAccess Or NotifyFilters.LastWrite Or NotifyFilters.FileName Or NotifyFilters.DirectoryName)
        ' Only watch text files.
        watcher.Filter = "*.txt"
        
        ' Add event handlers.
        AddHandler watcher.Changed, AddressOf OnChanged
        AddHandler watcher.Created, AddressOf OnChanged
        AddHandler watcher.Deleted, AddressOf OnChanged
        AddHandler watcher.Renamed, AddressOf OnRenamed
        
        ' Begin watching.
        watcher.EnableRaisingEvents = True
        
        ' Wait for the user to quit the program.
        Console.WriteLine("Press 'q' to quit the sample.")
        While Chr(Console.Read()) <> "q"c
        End While
    End Sub
     
    ' Define the event handlers.
    Private Shared Sub OnChanged(source As Object, e As FileSystemEventArgs)
        ' Specify what is done when a file is changed, created, or deleted.
        Console.WriteLine("File: " & e.FullPath & " " & e.ChangeType)
    End Sub    
    
    Private Shared Sub OnRenamed(source As Object, e As RenamedEventArgs)
        ' Specify what is done when a file is renamed.
        Console.WriteLine("File: {0} renamed to {1}", e.OldFullPath, e.FullPath)
    End Sub
    
End Class


[C#] 
public class Watcher
{

    public static void Main()
    {

        string[] args = System.Environment.GetCommandLineArgs();
 
        // If a directory is not specified, exit program.
        if(args.Length != 2)
        {
            // Display the proper way to call the program.
            Console.WriteLine("Usage: Watcher.exe (directory)");
            return;
        }

        // Create a new FileSystemWatcher and set its properties.
        FileSystemWatcher watcher = new FileSystemWatcher();
        watcher.Path = args[1];
        /* Watch for changes in LastAccess and LastWrite times, and 
           the renaming of files or directories. */
        watcher.NotifyFilter = NotifyFilters.LastAccess | NotifyFilters.LastWrite 
           | NotifyFilters.FileName | NotifyFilters.DirectoryName;
        // Only watch text files.
        watcher.Filter = "*.txt";

        // Add event handlers.
        watcher.Changed += new FileSystemEventHandler(OnChanged);
        watcher.Created += new FileSystemEventHandler(OnChanged);
        watcher.Deleted += new FileSystemEventHandler(OnChanged);
        watcher.Renamed += new RenamedEventHandler(OnRenamed);

        // Begin watching.
        watcher.EnableRaisingEvents = true;

        // Wait for the user to quit the program.
        Console.WriteLine("Press \'q\' to quit the sample.");
        while(Console.Read()!='q');
    }

    // Define the event handlers.
    private static void OnChanged(object source, FileSystemEventArgs e)
    {
        // Specify what is done when a file is changed, created, or deleted.
       Console.WriteLine("File: " +  e.FullPath + " " + e.ChangeType);
    }

    private static void OnRenamed(object source, RenamedEventArgs e)
    {
        // Specify what is done when a file is renamed.
        Console.WriteLine("File: {0} renamed to {1}", e.OldFullPath, e.FullPath);
    }
}


[C++] 
public __gc class Watcher
{
public:
    // Define the event handlers.
    static void OnChanged(Object* /*source*/, FileSystemEventArgs* e)
    {
        // Specify what is done when a file is changed, created, or deleted.
        Console::WriteLine(S"File: {0} {1}", e->FullPath, __box(e->ChangeType));
    }

    static void OnRenamed(Object* /*source*/, RenamedEventArgs* e)
    {
        // Specify what is done when a file is renamed.
        Console::WriteLine(S"File: {0} renamed to {1}", e->OldFullPath, e->FullPath);
    }
};


int main()
{

    String* args[] = System::Environment::GetCommandLineArgs();

    // If a directory is not specified, exit program.
    if(args->Length != 2)
    {
        // Display the proper way to call the program.
        Console::WriteLine(S"Usage: Watcher.exe (directory)");
        return 0;
    }

    // Create a new FileSystemWatcher and set its properties.
    FileSystemWatcher* watcher = new FileSystemWatcher();
    watcher->Path = args[1];
    /* Watch for changes in LastAccess and LastWrite times, and 
    the renaming of files or directories. */
    watcher->NotifyFilter = static_cast<NotifyFilters>( NotifyFilters::LastAccess | NotifyFilters::LastWrite 
        | NotifyFilters::FileName | NotifyFilters::DirectoryName );
    // Only watch text files.
    watcher->Filter = S"*.txt";

    // Add event handlers.
    watcher->Changed += new FileSystemEventHandler(0, Watcher::OnChanged);
    watcher->Created += new FileSystemEventHandler(0, Watcher::OnChanged);
    watcher->Deleted += new FileSystemEventHandler(0, Watcher::OnChanged);
    watcher->Renamed += new RenamedEventHandler(0, Watcher::OnRenamed);

    // Begin watching.
    watcher->EnableRaisingEvents = true;

    // Wait for the user to quit the program.
    Console::WriteLine(S"Press \'q\' to quit the sample.");
    while(Console::Read()!='q');
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

プラットフォーム: Windows NT Server 4.0, Windows NT Workstation 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

FileSystemWatcher クラス | FileSystemWatcher メンバ | System.IO 名前空間

次の方法で共有

FileSystemWatcher.EnableRaisingEvents プロパティ

プロパティ値

解説

使用例

必要条件

参照

その他のリソース