FileSystemWatcher コンストラクター

定義

名前空間:

System.IO

アセンブリ:

System.IO.FileSystem.Watcher.dll

FileSystemWatcher クラスの新しいインスタンスを初期化します。

オーバーロード

FileSystemWatcher()	FileSystemWatcher クラスの新しいインスタンスを初期化します。
FileSystemWatcher(String)	監視するディレクトリを指定して、FileSystemWatcher クラスの新しいインスタンスを初期化します。
FileSystemWatcher(String, String)	FileSystemWatcher クラスの新しいインスタンスを、監視するディレクトリとファイルの種類を指定して初期化します。

FileSystemWatcher()

ソース:

FileSystemWatcher.cs

FileSystemWatcher クラスの新しいインスタンスを初期化します。

public:
 FileSystemWatcher();

public FileSystemWatcher ();

Public Sub New ()

例

次の例では、FileSystemWatcher実行時に指定されたディレクトリをwatchする オブジェクトを作成します。 オブジェクトは FileSystemWatcher 、と 時刻の LastWrite 変化、 LastAccess およびディレクトリ内のテキスト ファイルの作成、削除、または名前変更を監視します。 ファイルが変更、作成、または削除されると、ファイルへのパスがコンソールに表示されます。 ファイルの名前が変更されると、古いパスと新しいパスがコンソールに表示されます。

この例では、 System.Diagnostics 名前空間と System.IO 名前空間を使用します。

#include "pch.h"

using namespace System;
using namespace System::IO;

class MyClassCPP
{
public:

    int static Run()
    {
        FileSystemWatcher^ watcher = gcnew FileSystemWatcher("C:\\path\\to\\folder");

        watcher->NotifyFilter = static_cast<NotifyFilters>(NotifyFilters::Attributes
                                                         | NotifyFilters::CreationTime
                                                         | NotifyFilters::DirectoryName
                                                         | NotifyFilters::FileName
                                                         | NotifyFilters::LastAccess
                                                         | NotifyFilters::LastWrite
                                                         | NotifyFilters::Security
                                                         | NotifyFilters::Size);

        watcher->Changed += gcnew FileSystemEventHandler(MyClassCPP::OnChanged);
        watcher->Created += gcnew FileSystemEventHandler(MyClassCPP::OnCreated);
        watcher->Deleted += gcnew FileSystemEventHandler(MyClassCPP::OnDeleted);
        watcher->Renamed += gcnew RenamedEventHandler(MyClassCPP::OnRenamed);
        watcher->Error   += gcnew ErrorEventHandler(MyClassCPP::OnError);

        watcher->Filter = "*.txt";
        watcher->IncludeSubdirectories = true;
        watcher->EnableRaisingEvents = true;

        Console::WriteLine("Press enter to exit.");
        Console::ReadLine();

        return 0;
    }

private:

    static void OnChanged(Object^ sender, FileSystemEventArgs^ e)
    {
        if (e->ChangeType != WatcherChangeTypes::Changed)
        {
            return;
        }
        Console::WriteLine("Changed: {0}", e->FullPath);
    }

    static void OnCreated(Object^ sender, FileSystemEventArgs^ e)
    {
        Console::WriteLine("Created: {0}", e->FullPath);
    }

    static void OnDeleted(Object^ sender, FileSystemEventArgs^ e)
    {
        Console::WriteLine("Deleted: {0}", e->FullPath);
    }

    static void OnRenamed(Object^ sender, RenamedEventArgs^ e)
    {
        Console::WriteLine("Renamed:");
        Console::WriteLine("    Old: {0}", e->OldFullPath);
        Console::WriteLine("    New: {0}", e->FullPath);
    }

    static void OnError(Object^ sender, ErrorEventArgs^ e)
    {
        PrintException(e->GetException());
    }

    static void PrintException(Exception^ ex)
    {
        if (ex != nullptr)
        {
            Console::WriteLine("Message: {0}", ex->Message);
            Console::WriteLine("Stacktrace:");
            Console::WriteLine(ex->StackTrace);
            Console::WriteLine();
            PrintException(ex->InnerException);
        }
    }
};


int main()
{
    MyClassCPP::Run();
}

using System;
using System.IO;

namespace MyNamespace
{
    class MyClassCS
    {
        static void Main()
        {
            using var watcher = new FileSystemWatcher(@"C:\path\to\folder");

            watcher.NotifyFilter = NotifyFilters.Attributes
                                 | NotifyFilters.CreationTime
                                 | NotifyFilters.DirectoryName
                                 | NotifyFilters.FileName
                                 | NotifyFilters.LastAccess
                                 | NotifyFilters.LastWrite
                                 | NotifyFilters.Security
                                 | NotifyFilters.Size;

            watcher.Changed += OnChanged;
            watcher.Created += OnCreated;
            watcher.Deleted += OnDeleted;
            watcher.Renamed += OnRenamed;
            watcher.Error += OnError;

            watcher.Filter = "*.txt";
            watcher.IncludeSubdirectories = true;
            watcher.EnableRaisingEvents = true;

            Console.WriteLine("Press enter to exit.");
            Console.ReadLine();
        }

        private static void OnChanged(object sender, FileSystemEventArgs e)
        {
            if (e.ChangeType != WatcherChangeTypes.Changed)
            {
                return;
            }
            Console.WriteLine($"Changed: {e.FullPath}");
        }

        private static void OnCreated(object sender, FileSystemEventArgs e)
        {
            string value = $"Created: {e.FullPath}";
            Console.WriteLine(value);
        }

        private static void OnDeleted(object sender, FileSystemEventArgs e) =>
            Console.WriteLine($"Deleted: {e.FullPath}");

        private static void OnRenamed(object sender, RenamedEventArgs e)
        {
            Console.WriteLine($"Renamed:");
            Console.WriteLine($"    Old: {e.OldFullPath}");
            Console.WriteLine($"    New: {e.FullPath}");
        }

        private static void OnError(object sender, ErrorEventArgs e) =>
            PrintException(e.GetException());

        private static void PrintException(Exception? ex)
        {
            if (ex != null)
            {
                Console.WriteLine($"Message: {ex.Message}");
                Console.WriteLine("Stacktrace:");
                Console.WriteLine(ex.StackTrace);
                Console.WriteLine();
                PrintException(ex.InnerException);
            }
        }
    }
}

Imports System.IO

Namespace MyNamespace

    Class MyClassVB

        Shared Sub Main()
            Using watcher = New FileSystemWatcher("C:\path\to\folder")
                watcher.NotifyFilter = NotifyFilters.Attributes Or
                                       NotifyFilters.CreationTime Or
                                       NotifyFilters.DirectoryName Or
                                       NotifyFilters.FileName Or
                                       NotifyFilters.LastAccess Or
                                       NotifyFilters.LastWrite Or
                                       NotifyFilters.Security Or
                                       NotifyFilters.Size

                AddHandler watcher.Changed, AddressOf OnChanged
                AddHandler watcher.Created, AddressOf OnCreated
                AddHandler watcher.Deleted, AddressOf OnDeleted
                AddHandler watcher.Renamed, AddressOf OnRenamed
                AddHandler watcher.Error, AddressOf OnError

                watcher.Filter = "*.txt"
                watcher.IncludeSubdirectories = True
                watcher.EnableRaisingEvents = True

                Console.WriteLine("Press enter to exit.")
                Console.ReadLine()
            End Using
        End Sub

        Private Shared Sub OnChanged(sender As Object, e As FileSystemEventArgs)
            If e.ChangeType <> WatcherChangeTypes.Changed Then
                Return
            End If
            Console.WriteLine($"Changed: {e.FullPath}")
        End Sub

        Private Shared Sub OnCreated(sender As Object, e As FileSystemEventArgs)
            Dim value As String = $"Created: {e.FullPath}"
            Console.WriteLine(value)
        End Sub

        Private Shared Sub OnDeleted(sender As Object, e As FileSystemEventArgs)
            Console.WriteLine($"Deleted: {e.FullPath}")
        End Sub

        Private Shared Sub OnRenamed(sender As Object, e As RenamedEventArgs)
            Console.WriteLine($"Renamed:")
            Console.WriteLine($"    Old: {e.OldFullPath}")
            Console.WriteLine($"    New: {e.FullPath}")
        End Sub

        Private Shared Sub OnError(sender As Object, e As ErrorEventArgs)
            PrintException(e.GetException())
        End Sub

        Private Shared Sub PrintException(ex As Exception)
            If ex IsNot Nothing Then
                Console.WriteLine($"Message: {ex.Message}")
                Console.WriteLine("Stacktrace:")
                Console.WriteLine(ex.StackTrace)
                Console.WriteLine()
                PrintException(ex.InnerException)
            End If
        End Sub

    End Class

End Namespace

注釈

Windows NTまたは Windows 2000 を持たないリモート コンピューターをwatchすることはできません。 Windows NT 4.0 コンピューターからリモート Windows NT 4.0 コンピューターをwatchすることはできません。

のインスタンスの初期プロパティ値を次の FileSystemWatcher表に示します。

プロパティ	初期値
NotifyFilter	、、および のLastWriteFileNameビットごとの OR の組み合わせDirectoryName
EnableRaisingEvents	false
Filter	"*.*" (すべてのファイルを監視します。)
IncludeSubdirectories	false
InternalBufferSize	8192
Path	空の文字列 ("")

注意

が設定され、 が になるまで、コンポーネントは指定されたディレクトリをPathEnableRaisingEventstruewatchしません。

こちらもご覧ください

• NotifyFilters
• FileSystemEventArgs
• FileSystemEventHandler
• InternalBufferOverflowException
• Path
• RenamedEventArgs
• RenamedEventHandler
• WaitForChangedResult
• WatcherChangeTypes

FileSystemWatcher(String)

ソース:

FileSystemWatcher.cs

監視するディレクトリを指定して、FileSystemWatcher クラスの新しいインスタンスを初期化します。

public:
 FileSystemWatcher(System::String ^ path);

public FileSystemWatcher (string path);

new System.IO.FileSystemWatcher : string -> System.IO.FileSystemWatcher

Public Sub New (path As String)

パラメーター

path

String

標準表記または UNC (Universal Naming Convention) 表記での監視するディレクトリ。

例外

ArgumentNullException

path パラメーターが null です。

ArgumentException

path パラメーターが空の文字列 ("") です。

- または -

path パラメーターで指定されたパスが存在しません。

PathTooLongException

path が長すぎます。

注釈

注意

が設定され、 が になるまで、コンポーネントは指定されたディレクトリをPathEnableRaisingEventstruewatchしません。

コンポーネントは、パーソナル コンピューター、ネットワーク ドライブ、またはリモート コンピューター上のファイルをwatchできます。

Windows NTまたは Windows 2000 を持たないリモート コンピューターをwatchすることはできません。 Windows NT 4.0 コンピューターからリモート Windows NT 4.0 コンピューターをwatchすることはできません。 プロパティはFilter、既定ですべてのファイルをwatchに設定されます。

こちらもご覧ください

• NotifyFilters
• FileSystemEventArgs
• FileSystemEventHandler
• Filter
• InternalBufferOverflowException
• Path
• RenamedEventArgs
• RenamedEventHandler
• WaitForChangedResult
• WatcherChangeTypes

FileSystemWatcher(String, String)

ソース:

FileSystemWatcher.cs

FileSystemWatcher クラスの新しいインスタンスを、監視するディレクトリとファイルの種類を指定して初期化します。

public:
 FileSystemWatcher(System::String ^ path, System::String ^ filter);

public FileSystemWatcher (string path, string filter);

new System.IO.FileSystemWatcher : string * string -> System.IO.FileSystemWatcher

Public Sub New (path As String, filter As String)

パラメーター

path

String

標準表記または UNC (Universal Naming Convention) 表記での監視するディレクトリ。

filter

String

ウォッチするファイルの種類。 たとえば、すべてのテキスト ファイルの変更をウォッチするには、"*.txt" に設定します。

例外

ArgumentNullException

path パラメーターが null です。

または

filter パラメーターが null です。

ArgumentException

path パラメーターが空の文字列 ("") です。

- または -

path パラメーターで指定されたパスが存在しません。

PathTooLongException

path が長すぎます。

注釈

注意

が設定され、 が になるまで、コンポーネントは指定されたディレクトリをPathEnableRaisingEventstruewatchしません。

コンポーネントは、パーソナル コンピューター、ネットワーク ドライブ、またはリモート コンピューター上のファイルをwatchできます。

Windows NTまたは Windows 2000 を持たないリモート コンピューターをwatchすることはできません。 Windows NT 4.0 コンピューターからリモート Windows NT 4.0 コンピューターをwatchすることはできません。

こちらもご覧ください

• NotifyFilters
• FileSystemEventArgs
• FileSystemEventHandler
• Filter
• InternalBufferOverflowException
• Path
• RenamedEventArgs
• RenamedEventHandler
• WaitForChangedResult
• WatcherChangeTypes