FileSystemWatcher.Filter Właściwość

Definicja

Przestrzeń nazw:

System.IO

Zestawy:

netstandard.dll, System.IO.FileSystem.Watcher.dll

Źródło:

FileSystemWatcher.cs

Pobiera lub ustawia ciąg filtru używany do określania, które pliki są monitorowane w katalogu.

public:
 property System::String ^ Filter { System::String ^ get(); void set(System::String ^ value); };

public string Filter { get; set; }

member this.Filter : string with get, set

Public Property Filter As String

Wartość właściwości

String

Ciąg filtru. Wartość domyślna to "*.*" (obserwuje wszystkie pliki).

Przykłady

Poniższy przykład tworzy obiekt , FileSystemWatcher aby obejrzeć katalog określony w czasie wykonywania. Składnik jest ustawiony, aby obserwować zmiany w czasie LastWrite i LastAccess , tworzenie, usuwanie lub zmienianie nazw plików tekstowych w katalogu. Jeśli plik zostanie zmieniony, utworzony lub usunięty, ścieżka do pliku zostanie wyświetlona w konsoli programu . Po zmianie nazwy pliku stare i nowe ścieżki są drukowane w konsoli programu .

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

Uwagi

Aby obserwować zmiany we wszystkich plikach, ustaw Filter właściwość na pusty ciąg (""). Aby obejrzeć określony plik, ustaw Filter właściwość na nazwę pliku. Aby na przykład monitorować zmiany w pliku MyDoc.txt, ustaw właściwość Filter na wartość "MyDoc.txt". Możesz również obserwować zmiany w określonym typie pliku. Aby na przykład wyszukać zmiany w dowolnych plikach tekstowych, ustaw Filter właściwość na "*.txt". Użycie wielu filtrów, takich jak "*.txt|*.doc", nie jest obsługiwane.

Właściwość Filter można zmienić po rozpoczęciu odbierania FileSystemWatcher zdarzeń przez obiekt.

Aby uzyskać więcej informacji na temat filtrowania niechcianych powiadomień, zobacz NotifyFilterwłaściwości , IncludeSubdirectoriesi InternalBufferSize .

Filter akceptuje symbole wieloznaczne dla pasujących plików, jak pokazano w poniższych przykładach.

Ciąg filtru	Obserwuje następujące pliki
*.*	Wszystkie pliki (wartość domyślna). Pusty ciąg ("") również obserwuje wszystkie pliki.
*.txt	Wszystkie pliki z rozszerzeniem "txt".
*recipe.doc	Wszystkie pliki kończące się rozszerzeniem "przepis" z rozszerzeniem "doc".
win*.xml	Wszystkie pliki rozpoczynające się od "win" z rozszerzeniem "xml".
Sprzedaż*200?.xls	Dopasuj następujące elementy: - Sprzedaż w lipcu 2001.xls - Sprzedaż w sierpniu 2002.xls - Sprzedaż 2004.xls marca ale nie pasuje do: - Sprzedaż listopada 1999.xls
MyReport.Doc	Zegarki tylko MyReport.doc

Zobacz też

• NotifyFilter
• IncludeSubdirectories
• InternalBufferSize