FileSystemWatcher.Filter Eigenschap

Definitie

Naamruimte:

System.IO

Assembly:

System.dll

Hiermee haalt u de filtertekenreeks op die wordt gebruikt om te bepalen welke bestanden in een map worden bewaakt.

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

[System.IO.IODescription("FSW_Filter")]
[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Filter { get; set; }

[<System.IO.IODescription("FSW_Filter")>]
[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Filter : string with get, set

Public Property Filter As String

Waarde van eigenschap

String

De filtertekenreeks. De standaardwaarde is '*.*' (Alle bestanden worden bewaakt.)

Kenmerken

TypeConverterAttribute IODescriptionAttribute SettingsBindableAttribute

Voorbeelden

In het volgende voorbeeld wordt een FileSystemWatcher map gemaakt die tijdens de runtime is opgegeven. Het onderdeel is ingesteld om te kijken naar wijzigingen in LastWrite en LastAccess tijd, het maken, verwijderen of hernoemen van tekstbestanden in de map. Als een bestand wordt gewijzigd, gemaakt of verwijderd, wordt het pad naar het bestand afgedrukt naar de console. Wanneer de naam van een bestand wordt gewijzigd, worden de oude en nieuwe paden afgedrukt naar de console.

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

Opmerkingen

Als u wijzigingen in alle bestanden wilt bekijken, stelt u de Filter eigenschap in op een lege tekenreeks (""). Als u een specifiek bestand wilt bekijken, stelt u de Filter eigenschap in op de bestandsnaam. Als u bijvoorbeeld wilt controleren op wijzigingen in het bestand MyDoc.txt, stelt u de Filter eigenschap in op "MyDoc.txt". U kunt ook letten op wijzigingen in een bepaald type bestand. Als u bijvoorbeeld wilt kijken naar wijzigingen in tekstbestanden, stelt u de Filter eigenschap in op '*.txt'. Het gebruik van meerdere filters, zoals '*.txt|*.doc', wordt niet ondersteund.

De Filter eigenschap kan worden gewijzigd nadat het FileSystemWatcher object gebeurtenissen heeft ontvangen.

Zie de NotifyFilter, IncludeSubdirectoriesen InternalBufferSize eigenschappen voor meer informatie over het filteren van ongewenste meldingen.

Filter accepteert jokertekens voor overeenkomende bestanden, zoals wordt weergegeven in de volgende voorbeelden.

Filtertekenreeks	Bekijkt de volgende bestanden
*.*	Alle bestanden (standaard). Met een lege tekenreeks ("") worden ook alle bestanden bewaakt.
*.txt	Alle bestanden met de extensie txt.
*recipe.doc	Alle bestanden eindigen op 'recept' met een 'doc'-extensie.
win*.xml	Alle bestanden beginnen met 'win' met een xml-extensie.
Verkoop*200?.xls	Komt overeen met het volgende: - Verkoop juli 2001.xls - Verkoop aug 2002.xls - Verkoop maart 2004.xls maar komt niet overeen met: - Verkoop nov 1999.xls
MyReport.Doc	Alleen MyReport.doc horloges

Zie ook

• NotifyFilter
• IncludeSubdirectories
• InternalBufferSize