FileSystemWatcher

.NET Framework クラス ライブラリ リファレンス

FileSystemWatcher イベント

パブリック イベント

	名前	説明
	Changed	指定した Path のファイルまたはディレクトリが変更されたときに発生します。
	Created	指定した Path のファイルまたはディレクトリが作成されたときに発生します。
	Deleted	指定した Path のファイルまたはディレクトリが削除されたときに発生します。
	Disposed	コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。 ( Component から継承されます。)
	Error	内部バッファがオーバーフローしたときに発生します。
	Renamed	指定した Path のファイルまたはディレクトリの名前が変更されたときに発生します。

参照

関連項目

FileSystemWatcher クラス
System.IO 名前空間
FileSystemWatcher.NotifyFilter プロパティ
NotifyFilters
FileSystemEventArgs クラス
FileSystemEventHandler デリゲート
FileSystemWatcher.Filter プロパティ
FileSystemWatcher.IncludeSubdirectories プロパティ
InternalBufferOverflowException
RenamedEventArgs
RenamedEventHandler
WaitForChangedResult
WatcherChangeTypes

FileSystemWatcher クラス

ファイル システムの変更通知を待機し、ディレクトリまたはディレクトリ内のファイルが変更されたときにイベントを発生させます。

名前空間: System.IO
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Class FileSystemWatcher
    Inherits Component
    Implements ISupportInitialize

Visual Basic (使用法)

Dim instance As FileSystemWatcher

C#

public class FileSystemWatcher : Component,
 ISupportInitialize

C++

public ref class FileSystemWatcher : public
 Component, ISupportInitialize

J#

public class FileSystemWatcher extends Component
 implements ISupportInitialize

JScript

public class FileSystemWatcher extends
 Component implements ISupportInitialize

解説

指定したディレクトリの変更をウォッチするには、FileSystemWatcher を使用します。指定したディレクトリのファイルとサブディレクトリの変更をウォッチできます。ローカル コンピュータ、ネットワーク ドライブ、またはリモート コンピュータのファイルをウォッチするコンポーネントを作成できます。

拡張子を持つすべてのファイルの変更をウォッチするには、Filter プロパティに空の文字列 ("") を設定するか、ワイルドカード ("*.*") を使用します。特定のファイルをウォッチするには、Filter プロパティにそのファイル名を設定します。たとえば、ファイル MyDoc.txt の変更をウォッチするには、Filter プロパティに "MyDoc.txt" を設定します。特定の種類のファイルの変更もウォッチできます。たとえば、テキスト ファイルの変更をウォッチするには、Filter プロパティに "*.txt" を設定します。

ディレクトリまたはファイルで、さまざまな種類の変更をウォッチできます。たとえば、ファイルまたはディレクトリの Attributes、LastWrite の日付と時刻、または Size の変更をウォッチできます。NotifyFilter プロパティに NotifyFilters 値の 1 つを設定すると、実行されます。ウォッチできる変更の種類の詳細については、NotifyFilters のトピックを参照してください。

ファイルまたはディレクトリの名前変更、削除、または作成をウォッチできます。たとえば、テキスト ファイルの名前の変更をウォッチするには、Filter プロパティに "*.txt" を設定し、パラメータに Renamed を指定して WaitForChanged メソッドを呼び出します。

Windows オペレーティング システムは、FileSystemWatcher によって作成されたバッファ内のファイルの変更をコンポーネントに通知します。短時間に多くの変更が発生すると、バッファがオーバーフローすることがあります。これにより、コンポーネントはディレクトリの変更は追跡せず、ブランケットの通知だけを行います。InternalBufferSize プロパティを使用してバッファのサイズを大きくすると、そのメモリはディスクにスワップ アウトできない非ページ メモリから割り当てられるため、負荷が大きくなります。そのため、バッファはできるだけ小さくしますが、ファイル変更イベントが見落とされない程度の大きさは維持してください。バッファ オーバーフローを防ぐには、NotifyFilter プロパティと IncludeSubdirectories プロパティを使用して、不要な変更通知をフィルタで排除します。

FileSystemWatcher のインスタンスの初期プロパティ値の一覧については、FileSystemWatcher コンストラクタのトピックを参照してください。

FileSystemWatcher クラスを使用する際には、次の項目に注意してください。

• 隠しファイルは無視されません。

• 一部のシステムでは、FileSystemWatcher はファイルへの変更を 8.3 の短いファイル名形式を使用して報告します。たとえば、"LongFileName.LongExtension" に加えられた変更が "LongFi~.Lon" として報告されます。

• このクラスは、すべてのメンバに適用されるリンク確認要求および継承確認要求をクラス レベルで格納します。直前の呼び出し元または派生クラスに完全信頼のアクセス許可がない場合、SecurityException がスローされます。セキュリティ要求の詳細については、「リンク確認要求」を参照してください。

フォルダのコピーと移動

オペレーティング システムと FileSystemWatcher オブジェクトは、切り取り/貼り付けアクションまたは移動アクションを、フォルダとその内容の名前変更アクションとして解釈します。ファイルが格納されたフォルダを切り取り、ウォッチ対象のフォルダに貼り付けた場合、FileSystemWatcher オブジェクトは、フォルダだけを新規フォルダとして報告します。フォルダの内容は基本的に名前が変更されるだけであるため報告されません。

フォルダの内容がウォッチ対象フォルダに移動またはコピーされたことを通知するには、次の表に示すように、OnChanged および OnRenamed の各イベント ハンドラ メソッドを提供します。

イベント ハンドラ	処理されるイベント	実行内容
OnChanged	Changed, Created, Deleted	ファイル属性の変更、作成されたファイル、および削除されたファイルを報告します。
OnRenamed	Renamed	名前が変更されたファイルまたはフォルダの新旧のパスを示します。必要に応じて再帰的に拡張できます。

イベントとバッファ サイズ

発生するファイル システム変更イベントの種類は、次に説明する複数の要因によって決まります。

• 一般的なファイル システム操作で、複数のイベントが発生することがあります。たとえば、あるディレクトリから別のディレクトリにファイルを移動するとき、複数の OnChanged、OnCreated、OnDeleted の各イベントが発生することがあります。ファイルの移動は、複数の単純な操作から構成される複雑な操作です。そのため、複数のイベントが発生します。同様に、一部のアプリケーション (ウイルス対策ソフトウェアなど) では追加のファイル システム イベントが発生し、FileSystemWatcher で検出されることがあります。

• FileSystemWatcher は、切り替えられたり、削除されたりしない限り、ディスクをウォッチできます。CD および DVD の場合、タイム スタンプおよびプロパティが変更されることはないため、FileSystemWatcher がイベントを発生させることはありません。リモート コンピュータでコンポーネントを正しく動作させるには、必要なプラットフォームの 1 つをインストールする必要があります。ただし、Windows NT 4.0 コンピュータからはリモート Windows NT 4.0 コンピュータをウォッチできません。

• Service Pack 1 適用前の Windows XP、または SP2 以前の Windows 2000 で、複数の FileSystemWatcher オブジェクトが同じ UNC パスをウォッチしている場合は、その中の 1 つのオブジェクトによってのみイベントが発生します。Windows XP SP1 以降、Windows 2000 SP3 以降、または Windows Server 2003 以降のオペレーティング システムを実行しているコンピュータの場合は、すべての FileSystemWatcher オブジェクトによって適切なイベントが発生します。

• Filter の設定によって、バッファに格納されるデータが減少することはありません。

イベントが見落とされた場合、またはバッファ サイズを超えた場合、Windows オペレーティング システムとの依存関係により、FileSystemWatcher によって Error イベントが発生することはありません。イベントを見落とさないために、次のガイドラインに従ってください。

• InternalBufferSize プロパティを使用してバッファ サイズを大きくすることで、ファイル システム変更イベントの見落としを予防できます。

• ロング ファイル名を使ってウォッチすることは避けます。短い名前に変更することを検討してください。

• イベントの処理コードをできるだけ短くします。

使用例

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

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

Visual Basic

Public Class Watcher
    
    Public Shared Sub Main()
    
         Run()
  
    End Sub

    <PermissionSet(SecurityAction.Demand, Name:="FullTrust")>
 _
    Private Shared Sub Run

      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()
    {
    Run();

    }

    [PermissionSet(SecurityAction.Demand, Name="FullTrust")]
    public static void Run()
    {
        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 ref class Watcher
{
private:
   // 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( "File: {0} {1}", e->FullPath, e->ChangeType
 );
   }

   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 );
   }

public:
   [PermissionSet(SecurityAction::Demand, Name="FullTrust")]
   int static run()
   {
      array<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 0;
      }

      // Create a new FileSystemWatcher and set its properties.
      FileSystemWatcher^ watcher = gcnew 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 = "*.txt";

      // Add event handlers.
      watcher->Changed += gcnew FileSystemEventHandler( Watcher::OnChanged );
      watcher->Created += gcnew FileSystemEventHandler( Watcher::OnChanged );
      watcher->Deleted += gcnew FileSystemEventHandler( Watcher::OnChanged );
      watcher->Renamed += gcnew RenamedEventHandler( Watcher::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' )
         ;
   }
};

int main() {
   Watcher::run();
}

J#

public class Watcher
{
    public static void main(String[]
 args1)
    {
    Run();
    } 

    /** @attribute PermissionSet(SecurityAction.Demand, Name="FullTrust")
     */
    public static void Run()
    {
        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.set_Path(args[1]);

        /* Watch for changes in LastAccess
 and LastWrite times, and 
           the renaming of files or directories.
         */
        watcher.set_NotifyFilter
            (NotifyFilters.LastAccess |NotifyFilters.LastWrite |
            NotifyFilters.FileName | NotifyFilters.DirectoryName);

        // Only watch text files.
        watcher.set_Filter("*.txt");

        // Add event handlers.
        watcher.add_Changed(new FileSystemEventHandler(OnChanged));
        watcher.add_Created(new FileSystemEventHandler(OnChanged));
        watcher.add_Deleted(new FileSystemEventHandler(OnChanged));
        watcher.add_Renamed(new RenamedEventHandler(OnRenamed));

        // Begin watching.
        watcher.set_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.get_FullPath() + " "
 
            + e.get_ChangeType()));
    } //OnChanged

    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.get_OldFullPath(),e.get_FullPath());
    } //OnRenamed
} //Watcher

.NET Framework のセキュリティ

• SecurityPermission  (ProcessStartInfo のメンバを呼び出すためのアクセス許可)。要求値 : LinkDemand; 名前付きアクセス許可セット : FullTrust。
• SecurityPermission  (ProcessStartInfo クラスから派生させるために必要なアクセス許可)。要求値 : InheritanceDemand; 名前付きアクセス許可セット : FullTrust。

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
      System.IO.FileSystemWatcher

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
FileSystemWatcher メンバ
System.IO 名前空間
FileSystemWatcher.NotifyFilter
NotifyFilters
FileSystemEventArgs クラス
FileSystemEventHandler デリゲート
Filter
IncludeSubdirectories
InternalBufferOverflowException
RenamedEventArgs
RenamedEventHandler
WaitForChangedResult
WatcherChangeTypes

FileSystemWatcher コンストラクタ ()

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

名前空間: System.IO
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New FileSystemWatcher

C#

public FileSystemWatcher ()

C++

public:
FileSystemWatcher ()

J#

public FileSystemWatcher ()

JScript

public function FileSystemWatcher ()

解説

Windows NT または Windows 2000 を搭載していないリモート コンピュータは監視できません。Windows NT 4.0 コンピュータからリモートの Windows NT 4.0 コンピュータを監視することもできません。

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

プロパティ	初期値
NotifyFilter	LastWrite、FileName、および DirectoryName のビットごとの OR の組み合わせ。
EnableRaisingEvents	false
Filter	"*.*"。拡張子を持つすべてのファイルをウォッチします。たとえば、"MyFile.txt" はウォッチしますが、"README" はウォッチしません。
IncludeSubdirectories	false
InternalBufferSize	8192
Path	空の文字列 ("")。

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

使用例

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

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

Visual Basic

Public Class Watcher
    
    Public Shared Sub Main()
    
         Run()
  
    End Sub

    <PermissionSet(SecurityAction.Demand, Name:="FullTrust")>
 _
    Private Shared Sub Run

      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()
    {
    Run();

    }

    [PermissionSet(SecurityAction.Demand, Name="FullTrust")]
    public static void Run()
    {
        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 ref class Watcher
{
private:
   // 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( "File: {0} {1}", e->FullPath, e->ChangeType
 );
   }

   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 );
   }

public:
   [PermissionSet(SecurityAction::Demand, Name="FullTrust")]
   int static run()
   {
      array<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 0;
      }

      // Create a new FileSystemWatcher and set its properties.
      FileSystemWatcher^ watcher = gcnew 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 = "*.txt";

      // Add event handlers.
      watcher->Changed += gcnew FileSystemEventHandler( Watcher::OnChanged );
      watcher->Created += gcnew FileSystemEventHandler( Watcher::OnChanged );
      watcher->Deleted += gcnew FileSystemEventHandler( Watcher::OnChanged );
      watcher->Renamed += gcnew RenamedEventHandler( Watcher::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' )
         ;
   }
};

int main() {
   Watcher::run();
}

J#

public class Watcher
{
    public static void main(String[]
 args1)
    {
    Run();
    } 

    /** @attribute PermissionSet(SecurityAction.Demand, Name="FullTrust")
     */
    public static void Run()
    {
        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.set_Path(args[1]);

        /* Watch for changes in LastAccess
 and LastWrite times, and 
           the renaming of files or directories.
         */
        watcher.set_NotifyFilter
            (NotifyFilters.LastAccess |NotifyFilters.LastWrite |
            NotifyFilters.FileName | NotifyFilters.DirectoryName);

        // Only watch text files.
        watcher.set_Filter("*.txt");

        // Add event handlers.
        watcher.add_Changed(new FileSystemEventHandler(OnChanged));
        watcher.add_Created(new FileSystemEventHandler(OnChanged));
        watcher.add_Deleted(new FileSystemEventHandler(OnChanged));
        watcher.add_Renamed(new RenamedEventHandler(OnRenamed));

        // Begin watching.
        watcher.set_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.get_FullPath() + " "
 
            + e.get_ChangeType()));
    } //OnChanged

    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.get_OldFullPath(),e.get_FullPath());
    } //OnRenamed
} //Watcher

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
FileSystemWatcher クラス
FileSystemWatcher メンバ
System.IO 名前空間
NotifyFilters
FileSystemEventArgs クラス
FileSystemEventHandler デリゲート
InternalBufferOverflowException
Path
RenamedEventArgs
RenamedEventHandler
WaitForChangedResult
WatcherChangeTypes

FileSystemWatcher コンストラクタ (String, String)

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

名前空間: System.IO
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim path As String
Dim filter As String

Dim instance As New FileSystemWatcher(path,
 filter)

C#

public FileSystemWatcher (
    string path,
    string filter
)

C++

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

J#

public FileSystemWatcher (
    String path, 
    String filter
)

JScript

public function FileSystemWatcher (
    path : String, 
    filter : String
)

パラメータ

path

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

filter

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

例外

例外の種類	条件
ArgumentNullException	path パラメータが null 参照 (Visual Basic では Nothing) です。 または filter パラメータが null 参照 (Visual Basic では Nothing) です。
ArgumentException	path パラメータが空の文字列 ("") です。 または path パラメータで指定されたパスが存在しません。

解説

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

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

Windows NT または Windows 2000 を搭載していないリモート コンピュータは監視できません。Windows NT 4.0 コンピュータからリモートの Windows NT 4.0 コンピュータを監視することもできません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
FileSystemWatcher クラス
FileSystemWatcher メンバ
System.IO 名前空間
NotifyFilters
FileSystemEventArgs クラス
FileSystemEventHandler デリゲート
Filter
InternalBufferOverflowException
Path
RenamedEventArgs
RenamedEventHandler
WaitForChangedResult
WatcherChangeTypes

FileSystemWatcher コンストラクタ (String)

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

名前空間: System.IO
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    path As String _
)

Visual Basic (使用法)

Dim path As String

Dim instance As New FileSystemWatcher(path)

C#

public FileSystemWatcher (
    string path
)

C++

public:
FileSystemWatcher (
    String^ path
)

J#

public FileSystemWatcher (
    String path
)

JScript

public function FileSystemWatcher (
    path : String
)

パラメータ

path

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

例外

例外の種類	条件
ArgumentNullException	path パラメータが null 参照 (Visual Basic では Nothing) です。
ArgumentException	path パラメータが空の文字列 ("") です。 または path パラメータで指定されたパスが存在しません。

解説

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

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

Windows NT または Windows 2000 を搭載していないリモート コンピュータは監視できません。Windows NT 4.0 コンピュータからリモートの Windows NT 4.0 コンピュータを監視することもできません。既定では、Filter プロパティはすべてのファイルをウォッチするように設定されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
FileSystemWatcher クラス
FileSystemWatcher メンバ
System.IO 名前空間
NotifyFilters
FileSystemEventArgs クラス
FileSystemEventHandler デリゲート
Filter
InternalBufferOverflowException
Path
RenamedEventArgs
RenamedEventHandler
WaitForChangedResult
WatcherChangeTypes

FileSystemWatcher コンストラクタ

FileSystemWatcher クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

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

参照

関連項目

FileSystemWatcher クラス
FileSystemWatcher メンバ
System.IO 名前空間
NotifyFilters
FileSystemEventArgs クラス
FileSystemEventHandler デリゲート
InternalBufferOverflowException
Path
RenamedEventArgs
RenamedEventHandler
WaitForChangedResult
WatcherChangeTypes

FileSystemWatcher プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Container	Component を格納している IContainer を取得します。 ( Component から継承されます。)
	EnableRaisingEvents	コンポーネントが有効かどうかを示す値を取得または設定します。
	Filter	ディレクトリで監視するファイルを決定するために使用するフィルタ文字列を取得または設定します。
	IncludeSubdirectories	指定したパスのサブディレクトリを監視するかどうかを示す値を取得または設定します。
	InternalBufferSize	内部バッファのサイズを取得または設定します。
	NotifyFilter	ウォッチする変更の種類を取得または設定します。
	Path	ウォッチするディレクトリのパスを取得または設定します。
	Site	オーバーライドされます。 FileSystemWatcher の ISite を取得または設定します。
	SynchronizingObject	ディレクトリ変更の結果として発行されるイベント ハンドラ呼び出しをマーシャリングするために使用するオブジェクトを取得または設定します。

プロテクト プロパティ

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 ( Component から継承されます。)
	DesignMode	Component が現在デザイン モードかどうかを示す値を取得します。 ( Component から継承されます。)
	Events	Component に結び付けられているイベント ハンドラのリストを取得します。 ( Component から継承されます。)

参照

関連項目

FileSystemWatcher クラス
System.IO 名前空間
FileSystemWatcher.NotifyFilter
NotifyFilters
FileSystemEventArgs クラス
FileSystemEventHandler デリゲート
Filter
IncludeSubdirectories
InternalBufferOverflowException
RenamedEventArgs
RenamedEventHandler
WaitForChangedResult
WatcherChangeTypes

FileSystemWatcher メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	BeginInit	フォームまたは別のコンポーネントで使用する FileSystemWatcher の初期化を開始します。初期化は実行時に発生します。
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。 FileSystemWatcher によって使用されているリソースを解放します。
	EndInit	フォームまたは別のコンポーネントで使用する FileSystemWatcher の初期化を終了します。初期化は実行時に発生します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 ( Component から継承されます。)
	WaitForChanged	オーバーロードされます。 発生した変更についての固有な情報を格納する構造体を返す同期メソッド。

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 オーバーライドされます。 FileSystemWatcher によって使用されているリソースを解放します。
	Finalize	Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 ( Component から継承されます。)
	GetService	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 ( Component から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)
	OnChanged	Changed イベントを発生させます。
	OnCreated	Created イベントを発生させます。
	OnDeleted	Deleted イベントを発生させます。
	OnError	Error イベントを発生させます。
	OnRenamed	Renamed イベントを発生させます。

参照

関連項目

FileSystemWatcher クラス
System.IO 名前空間
FileSystemWatcher.NotifyFilter
NotifyFilters
FileSystemEventArgs クラス
FileSystemEventHandler デリゲート
Filter
IncludeSubdirectories
InternalBufferOverflowException
RenamedEventArgs
RenamedEventHandler
WaitForChangedResult
WatcherChangeTypes

FileSystemWatcher メンバ

ファイル システムの変更通知を待機し、ディレクトリまたはディレクトリ内のファイルが変更されたときにイベントを発生させます。

FileSystemWatcher データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	FileSystemWatcher	オーバーロードされます。 FileSystemWatcher クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	Container	Component を格納している IContainer を取得します。(Component から継承されます。)
	EnableRaisingEvents	コンポーネントが有効かどうかを示す値を取得または設定します。
	Filter	ディレクトリで監視するファイルを決定するために使用するフィルタ文字列を取得または設定します。
	IncludeSubdirectories	指定したパスのサブディレクトリを監視するかどうかを示す値を取得または設定します。
	InternalBufferSize	内部バッファのサイズを取得または設定します。
	NotifyFilter	ウォッチする変更の種類を取得または設定します。
	Path	ウォッチするディレクトリのパスを取得または設定します。
	Site	オーバーライドされます。 FileSystemWatcher の ISite を取得または設定します。
	SynchronizingObject	ディレクトリ変更の結果として発行されるイベント ハンドラ呼び出しをマーシャリングするために使用するオブジェクトを取得または設定します。

プロテクト プロパティ

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。(Component から継承されます。)
	DesignMode	Component が現在デザイン モードかどうかを示す値を取得します。(Component から継承されます。)
	Events	Component に結び付けられているイベント ハンドラのリストを取得します。(Component から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	BeginInit	フォームまたは別のコンポーネントで使用する FileSystemWatcher の初期化を開始します。初期化は実行時に発生します。
	CreateObjRef	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
	Dispose	オーバーロードされます。 FileSystemWatcher によって使用されているリソースを解放します。
	EndInit	フォームまたは別のコンポーネントで使用する FileSystemWatcher の初期化を終了します。初期化は実行時に発生します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 (Component から継承されます。)
	WaitForChanged	オーバーロードされます。 発生した変更についての固有な情報を格納する構造体を返す同期メソッド。

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 オーバーライドされます。 FileSystemWatcher によって使用されているリソースを解放します。
	Finalize	Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 (Component から継承されます。)
	GetService	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 (Component から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)
	OnChanged	Changed イベントを発生させます。
	OnCreated	Created イベントを発生させます。
	OnDeleted	Deleted イベントを発生させます。
	OnError	Error イベントを発生させます。
	OnRenamed	Renamed イベントを発生させます。

パブリック イベント

	名前	説明
	Changed	指定した Path のファイルまたはディレクトリが変更されたときに発生します。
	Created	指定した Path のファイルまたはディレクトリが作成されたときに発生します。
	Deleted	指定した Path のファイルまたはディレクトリが削除されたときに発生します。
	Disposed	コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。(Component から継承されます。)
	Error	内部バッファがオーバーフローしたときに発生します。
	Renamed	指定した Path のファイルまたはディレクトリの名前が変更されたときに発生します。

参照

関連項目

FileSystemWatcher クラス
System.IO 名前空間
FileSystemWatcher.NotifyFilter
NotifyFilters
FileSystemEventArgs クラス
FileSystemEventHandler デリゲート
Filter
IncludeSubdirectories
InternalBufferOverflowException
RenamedEventArgs
RenamedEventHandler
WaitForChangedResult
WatcherChangeTypes