FileSystemWatcher.Filter Vlastnost

Definice

Obor názvů:

System.IO

Sestavení:

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

Zdroj:

FileSystemWatcher.cs

Získá nebo nastaví filtr řetězec použitý k určení, které soubory jsou monitorovány v adresáři.

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

Hodnota vlastnosti

String

Řetězec filtru. Výchozí hodnota je *.*(Sleduje všechny soubory.)

Příklady

Následující příklad vytvoří FileSystemWatcher sledování adresáře určeného za běhu. Komponenta je nastavená tak, aby sledovala změny v LastWrite čase, LastAccess vytváření, odstraňování nebo přejmenování textových souborů v adresáři. Pokud se soubor změní, vytvoří nebo odstraní, cesta k souboru se vytiskne do konzoly. Při přejmenování souboru se staré a nové cesty vytisknou do konzoly.

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

Poznámky

Pokud chcete sledovat změny ve všech souborech, nastavte Filter vlastnost na prázdný řetězec (""). Pokud chcete sledovat konkrétní soubor, nastavte Filter vlastnost na název souboru. Pokud chcete například sledovat změny v souboru MyDoc.txt, nastavte Filter vlastnost na "MyDoc.txt". Můžete také sledovat změny v určitém typu souboru. Pokud chcete například sledovat změny v libovolných textových souborech, nastavte Filter vlastnost na "*.txt". Použití více filtrů, například *.txt|*.doc, není podporováno.

Filter Vlastnost lze změnit poté, co FileSystemWatcher objekt začal přijímat události.

Další informace o odfiltrování nežádoucích oznámení naleznete v tématu NotifyFilter, IncludeSubdirectoriesa InternalBufferSize vlastnosti.

Filter přijímá zástupné cardy pro odpovídající soubory, jak je znázorněno v následujících příkladech.

Filtrovací řetězec	Sleduje následující soubory.
*.*	Všechny soubory (výchozí). Prázdný řetězec ("") také sleduje všechny soubory.
*.txt	Všechny soubory s příponou txt.
*recipe.doc	Všechny soubory končící na "recept" s příponou "doc".
win*.xml	Všechny soubory začínající na "win" s příponou "xml".
Sales*200?.xls	Odpovídá následujícímu: - Prodej červenec 2001.xls - Prodejní 2002.xls - Prodej březen 2004.xls ale neodpovídá: - Sales Nov 1999.xls
MyReport.Doc	Kukátkové hodinky pouze MyReport.doc

Viz také

• NotifyFilter
• IncludeSubdirectories
• InternalBufferSize