FileSystemWatcher.Path 속성

정의

네임스페이스:

System.IO

어셈블리:

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

Source:

FileSystemWatcher.cs

감시할 디렉터리의 경로를 가져오거나 설정합니다.

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

public string Path { get; set; }

member this.Path : string with get, set

Public Property Path As String

속성 값

String

모니터링할 경로입니다. 기본값은 빈 문자열("")입니다.

예외

ArgumentException

지정된 경로가 없거나 찾을 수 없습니다.

-또는-

지정된 경로에 와일드카드 문자가 포함됩니다.

-또는-

지정된 경로에 잘못된 경로 문자가 포함되어 있습니다.

예제

다음 예제에서는 런타임에 지정된 디렉터리를 감시하는 방법을 만듭니다 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

설명

디렉터리에 대한 정규화된 경로입니다. 속성이 IncludeSubdirectoriestrue면 이 디렉터리가 시스템에서 변경 내용을 감시하는 루트이고, 그렇지 않으면 감시된 유일한 디렉터리입니다. 특정 파일을 보려면 속성을 정규화된 올바른 디렉터리로 Filter 설정하고 속성을 파일 이름으로 설정합니다Path.

이 속성은 Path UNC(유니버설 명명 규칙) 경로를 지원합니다.

메모

구성 요소에서 변경 내용을 감시하려면 먼저 이 속성을 설정해야 합니다.

디렉터리의 이름이 바뀌 FileSystemWatcher 면 새로 이름이 바뀐 항목에 자동으로 다시 연결됩니다. 예를 들어 속성을 "C:\My Documents"로 설정한 다음 디렉터리의 이름을 수동으로 "C:\Your Documents"로 바꾸 Path 면 구성 요소는 새로 이름이 바뀐 디렉터리에서 변경 알림을 계속 수신 대기합니다. 그러나 속성을 요청 Path 하면 이전 경로가 포함됩니다. 이는 구성 요소가 디렉터리의 이름이 아닌 핸들을 기반으로 감시하는 디렉터리를 결정하기 때문에 발생합니다. 이름 바꾸기는 핸들에 영향을 주지 않습니다. 따라서 구성 요소를 삭제한 다음 속성을 업데이트 Path 하지 않고 다시 만들면 디렉터리가 더 이상 존재하지 않으므로 애플리케이션이 실패합니다.

추가 정보

• FileSystemWatcher
• Filter