FileSystemWatcher.Created Событие

Определение

Пространство имен:

System.IO

Сборки:

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

Исходный код:

FileSystemWatcher.cs

Происходит при создании файла или каталога в указанном каталоге Path .

public:
 event System::IO::FileSystemEventHandler ^ Created;

public event System.IO.FileSystemEventHandler? Created;

member this.Created : System.IO.FileSystemEventHandler 

Public Custom Event Created As FileSystemEventHandler 

Тип события

FileSystemEventHandler

Примеры

В следующем примере событие используется Created для отображения пути к файлу в консоль всякий раз при создании отслеживаемого файла.

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

Комментарии

Некоторые распространенные случаи, такие как копирование или перемещение файла или каталога, не соответствуют событиям напрямую, но эти вхождения вызывают события. При копировании файла или каталога система вызывает Created событие в каталоге, в который копируется файл, если этот каталог просматривается. Если каталог, из которого копировались, просматривается другим экземпляром FileSystemWatcher, событие не будет вызвано. Например, вы создаете два экземпляра FileSystemWatcher. FileSystemWatcher1 имеет значение "C:\My Documents", а FileSystemWatcher2 имеет значение "C:\Your Documents". Если скопировать файл из "Мои документы" в "Ваши документы", Created событие будет вызвано FileSystemWatcher2, но событие не вызывается для FileSystemWatcher1. В отличие от копирования, перемещение файла или каталога приведет к возникновению двух событий. В предыдущем примере, если вы переместили файл из "Мои документы" в "Ваши документы", Created событие будет вызвано FileSystemWatcher2, а Deleted событие будет вызвано FileSystemWatcher1.

Замечание

Распространенные операции файловой системы могут вызывать несколько событий. Например, при перемещении файла из одного каталога в другой может возникать несколько OnChanged и некоторые OnCreated и OnDeleted события. Перемещение файла — это сложная операция, состоящая из нескольких простых операций, поэтому вызывает несколько событий. Аналогичным образом, некоторые приложения (например, антивирусное программное обеспечение) могут вызвать дополнительные события файловой системы, обнаруженные FileSystemWatcher.

Замечание

Порядок, в котором Created событие вызывается в отношении других FileSystemWatcher событий, может измениться, если SynchronizingObject свойство не nullявляется.

Событие OnCreated возникает сразу после создания файла. Если файл копируется или передается в отслеживаемый каталог, OnCreated событие будет возникать немедленно, за которым следует одно или несколько OnChanged событий.

См. также раздел

• Deleted
• OnDeleted(FileSystemEventArgs)
• SynchronizingObject
• FileSystemEventArgs
• FileSystemEventHandler
• OnCreated(FileSystemEventArgs)