FileSystemWatcher.NotifyFilter プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

FileSystemWatcher.NotifyFilter プロパティ

ウォッチする変更の種類を取得または設定します。

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

Visual Basic (宣言)

Public Property NotifyFilter As
 NotifyFilters

Visual Basic (使用法)

Dim instance As FileSystemWatcher
Dim value As NotifyFilters

value = instance.NotifyFilter

instance.NotifyFilter = value

public NotifyFilters NotifyFilter { get; set;
 }

C++

public:
property NotifyFilters NotifyFilter {
    NotifyFilters get ();
    void set (NotifyFilters value);
}

/** @property */
public NotifyFilters get_NotifyFilter ()

/** @property */
public void set_NotifyFilter (NotifyFilters
 value)

JScript

public function get NotifyFilter
 () : NotifyFilters

public function set NotifyFilter
 (value : NotifyFilters)

プロパティ値
NotifyFilters 値の 1 つ。既定値は LastWrite、FileName、および DirectoryName のビットごとの OR の組み合わせです。

例外

例外の種類	条件
ArgumentException	値が、NotifyFilters 値の有効なビットごとの OR の組み合わせになっていません。

解説

NotifyFilters 列挙体のメンバを組み合わせて、一度に複数の種類の変更をウォッチできます。たとえば、ファイルのサイズの変更と LastWrite 時刻の変更をウォッチできます。この場合、ファイルまたはフォルダのサイズの変更や、ファイルまたはフォルダの LastWrite 時刻の変更が行われるたびにイベントが発生します。

これは、不必要な通知を排除する方法の 1 つです。不必要な通知をフィルタで排除する方法の詳細については、Filter、IncludeSubdirectories、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

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

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
FileSystemWatcher.Filter プロパティ
FileSystemWatcher.IncludeSubdirectories プロパティ
FileSystemWatcher.InternalBufferSize プロパティ

>> 「FileSystemWatcher.NotifyFilter プロパティ」を含む用語の索引
FileSystemWatcher.NotifyFilter プロパティのページへのリンク

FileSystemWatcher.NotifyFilter プロパティとは？わかりやすく解説

FileSystemWatcher.NotifyFilter プロパティ

「FileSystemWatcher.NotifyFilter プロパティ」の関連用語


	© 2024 Microsoft.All rights reserved.

FileSystemWatcher.NotifyFilter プロパティとは？ わかりやすく解説

FileSystemWatcher.NotifyFilter プロパティ

急上昇のことば

「FileSystemWatcher.NotifyFilter プロパティ」の関連用語

FileSystemWatcher.NotifyFilter プロパティとは？わかりやすく解説