FileSystemWatcher コンストラクター
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
FileSystemWatcher クラスの新しいインスタンスを初期化します。
オーバーロード
| 名前 | 説明 |
|---|---|
| FileSystemWatcher() |
FileSystemWatcher クラスの新しいインスタンスを初期化します。 |
| FileSystemWatcher(String) |
監視する指定されたディレクトリを指定して、 FileSystemWatcher クラスの新しいインスタンスを初期化します。 |
| FileSystemWatcher(String, String) |
監視するファイルの指定したディレクトリと種類を指定して、 FileSystemWatcher クラスの新しいインスタンスを初期化します。 |
FileSystemWatcher()
FileSystemWatcher クラスの新しいインスタンスを初期化します。
public:
FileSystemWatcher();
public FileSystemWatcher();
Public Sub New ()
例
次の例では、実行時に指定されたディレクトリを監視する FileSystemWatcher オブジェクトを作成します。
FileSystemWatcher オブジェクトは、LastWriteとLastAccess時間の変化、およびディレクトリ内のテキスト ファイルの作成、削除、または名前変更を監視します。 ファイルが変更、作成、または削除されると、ファイルへのパスがコンソールに表示されます。 ファイルの名前が変更されると、古いパスと新しいパスがコンソールに表示されます。
この例では、 System.Diagnostics と System.IO 名前空間を使用します。
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 を持たないリモート コンピューターを監視することはできません。 Windows NT 4.0 コンピューターからリモート Windows NT 4.0 コンピューターを監視することはできません。
次の表に、 FileSystemWatcherのインスタンスの初期プロパティ値を示します。
| 財産 | 初期値 |
|---|---|
| NotifyFilter |
LastWrite、FileName、および のビットごとの OR の組み合わせDirectoryName |
| EnableRaisingEvents | false |
| Filter | "*.*" (すべてのファイルを監視します。) |
| IncludeSubdirectories | false |
| InternalBufferSize | 8192 |
| Path | 空の文字列 ("") |
注
コンポーネントは、 Path が設定され、 EnableRaisingEvents が trueされるまで、指定されたディレクトリを監視しません。
こちらもご覧ください
- NotifyFilters
- FileSystemEventArgs
- FileSystemEventHandler
- InternalBufferOverflowException
- Path
- RenamedEventArgs
- RenamedEventHandler
- WaitForChangedResult
- WatcherChangeTypes
適用対象
FileSystemWatcher(String)
監視する指定されたディレクトリを指定して、 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) 表記で監視するディレクトリ。
例外
path パラメーターはnull。
path が長すぎます。
注釈
注
コンポーネントは、 Path が設定され、 EnableRaisingEvents が trueされるまで、指定されたディレクトリを監視しません。
コンポーネントは、パーソナル コンピューター、ネットワーク ドライブ、またはリモート コンピューター上のファイルを監視できます。
Windows NT または Windows 2000 を持たないリモート コンピューターを監視することはできません。 Windows NT 4.0 コンピューターからリモート Windows NT 4.0 コンピューターを監視することはできません。 既定では、 Filter プロパティは、すべてのファイルを監視するように設定されています。
こちらもご覧ください
- NotifyFilters
- FileSystemEventArgs
- FileSystemEventHandler
- Filter
- InternalBufferOverflowException
- Path
- RenamedEventArgs
- RenamedEventHandler
- WaitForChangedResult
- WatcherChangeTypes
適用対象
FileSystemWatcher(String, String)
監視するファイルの指定したディレクトリと種類を指定して、 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) 表記で監視するディレクトリ。
- filter
- String
監視するファイルの種類。 たとえば、"*.txt" は、すべてのテキスト ファイルへの変更を監視します。
例外
path が長すぎます。
注釈
注
コンポーネントは、 Path が設定され、 EnableRaisingEvents が trueされるまで、指定されたディレクトリを監視しません。
コンポーネントは、パーソナル コンピューター、ネットワーク ドライブ、またはリモート コンピューター上のファイルを監視できます。
Windows NT または Windows 2000 を持たないリモート コンピューターを監視することはできません。 Windows NT 4.0 コンピューターからリモート Windows NT 4.0 コンピューターを監視することはできません。
こちらもご覧ください
- NotifyFilters
- FileSystemEventArgs
- FileSystemEventHandler
- Filter
- InternalBufferOverflowException
- Path
- RenamedEventArgs
- RenamedEventHandler
- WaitForChangedResult
- WatcherChangeTypes