FileSystemWatcher.Filter 속성

정의

네임스페이스:

System.IO

어셈블리:

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

Source:

FileSystemWatcher.cs

디렉터리에서 모니터링되는 파일을 결정하는 데 사용되는 필터 문자열을 가져오거나 설정합니다.

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

속성 값

String

필터 문자열입니다. 기본값은 "*.*"입니다(모든 파일을 감시합니다.)

예제

다음 예제에서는 런타임에 지정된 디렉터리를 감시하는 방법을 만듭니다 FileSystemWatcher . 구성 요소는 디렉터리에서 LastWriteLastAccess 텍스트 파일의 생성, 삭제 또는 이름 바꾸기 및 시간 변경 내용을 감시하도록 설정됩니다. 파일이 변경, 생성 또는 삭제되면 파일 경로가 콘솔에 출력됩니다. 파일 이름을 바꾸면 이전 경로와 새 경로가 콘솔에 출력됩니다.

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

설명

모든 파일의 변경 내용을 확인하려면 속성을 빈 문자열("")로 설정합니다 Filter . 특정 파일을 보려면 속성을 파일 이름으로 설정합니다 Filter . 예를 들어 파일 MyDoc.txt변경 내용을 확인하려면 속성을 "MyDoc.txt"로 설정합니다 Filter . 특정 형식의 파일에서 변경 내용을 확인할 수도 있습니다. 예를 들어 텍스트 파일의 변경 내용을 확인하려면 속성을 "*.txt"로 설정합니다 Filter . "*.txt|*.doc"과 같은 여러 필터는 사용할 수 없습니다.

개체가 Filter 이벤트 수신을 FileSystemWatcher 시작한 후에 속성을 변경할 수 있습니다.

원치 않는 알림을 필터링하는 방법에 대한 자세한 내용은 , IncludeSubdirectories및 InternalBufferSize 속성을 참조NotifyFilter하세요.

Filter 는 다음 예제와 같이 일치하는 파일에 대해 와일드카드를 허용합니다.

필터 문자열	다음 파일을 감시합니다.
*.*	모든 파일(기본값). 빈 문자열("")도 모든 파일을 감시합니다.
*.txt	확장명은 "txt"인 모든 파일입니다.
*recipe.doc	모든 파일은 "doc" 확장으로 "recipe"으로 끝납니다.
win*.xml	"xml" 확장명은 "win"으로 시작하는 모든 파일입니다.
판매액*200?.xls	다음과 일치합니다. - 판매 7월 2001.xls - 판매 8월 2002.xls - 판매 3월 2004.xls 하지만 일치하지 않습니다. - 판매 11월 1999.xls
MyReport.Doc	시계는 MyReport.doc

추가 정보

• NotifyFilter
• IncludeSubdirectories
• InternalBufferSize