FileSystemWatcher-Klasse

Mit FileSystemWatcher können Sie die Änderungen in einem angegebenen Verzeichnis überwachen lassen. Änderungen in Dateien und Unterverzeichnissen des angegebenen Verzeichnisses können überwacht werden. Sie können eine Komponente zum Überwachen von Dateien auf einem lokalen Computer, einem Netzlaufwerk oder einem Remotecomputer erstellen.

Um Änderungen an allen Dateien zu überwachen, legen Sie die Filter-Eigenschaft auf eine leere Zeichenfolge ("") fest, oder verwenden Sie Platzhalterzeichen ("*.*"). Legen Sie zum Überwachen einer bestimmten Datei die Filter-Eigenschaft auf den Dateinamen fest. Damit z. B. die Datei MyDoc.txt auf Änderungen überwacht wird, legen Sie die Filter-Eigenschaft auf MyDoc.txt fest. Es kann auch ein bestimmten Dateityp auf Änderungen überwacht werden. Damit z. B. Textdateien auf Änderungen überwacht werden, legen Sie die Filter-Eigenschaft auf "*.txt" fest.

Ein Verzeichnis oder eine Datei kann auf verschiedene Arten von Änderungen überwacht werden. Dateien oder Verzeichnisse können z. B. auf Änderungen in Bezug auf Attributes, Datum und Uhrzeit von LastWrite und Size überwacht werden. Legen Sie dafür die NotifyFilter-Eigenschaft auf einen der NotifyFilters-Werte fest. Weitere Informationen darüber, welche Arten von Änderungen überwacht werden können, finden Sie unter NotifyFilters.

Das Umbenennen, Löschen oder Erstellen von Dateien oder Verzeichnissen kann überwacht werden. Das Umbenennen von Textdateien wird z. B. überwacht, wenn Sie die Filter-Eigenschaft auf "*.txt" festlegen und die WaitForChanged-Methode mit dem auf Renamed festgelegten Parameter aufrufen.

Das Betriebssystem Windows meldet der Komponente Änderungen an Dateien, die in einem von FileSystemWatcher erstellten Puffer vorgenommen wurden. Wenn in kurzen Abständen Änderungen vorgenommen werden, kann es zu einem Überlauf des Puffers kommen. Dies führt dazu, dass die Komponente die Änderungen im Verzeichnis nicht mehr verfolgen kann. Die Komponente kann dann nur allgemeine Benachrichtigungen bereitstellen. Das Erhöhen der Puffergröße mit der InternalBufferSize-Eigenschaft ist aufwändig, da Systemspeicher genutzt wird, der nicht auf die Festplatte ausgelagert werden kann. Der Puffer sollte deshalb so klein wie möglich gehalten werden, aber dennoch groß genug, um Dateiänderungsergebnisse erfassen zu können. Um einen Überlauf des Puffers zu vermeiden, verwenden Sie zum Herausfiltern nicht erwünschter Änderungsbenachrichtigungen die NotifyFilter-Eigenschaft und die IncludeSubdirectories-Eigenschaft.

Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz von FileSystemWatcher finden Sie unter FileSystemWatcher-Konstruktor.

Beachten Sie beim Verwenden der FileSystemWatcher-Klasse Folgendes.

• Versteckte Dateien werden nicht ignoriert.

• In einigen Systemen meldet FileSystemWatcher Änderungen an Dateien mit dem kurzen 8.3-Dateinamenformat. Eine Änderung an "LongFileName.LongExtension" würde dann beispielsweise als "LongFil~.Lon" gemeldet werden.

• Diese Klasse enthält eine Link- und eine Vererbungsanforderung auf der Klassenebene, die auf alle Member angewendet wird. Eine SecurityException wird ausgelöst, wenn der direkte Aufrufer oder die abgeleitete Klasse nicht über vollständige vertrauenswürdige Berechtigungen verfügen. Ausführliche Informationen über Sicherheitsanforderungen finden Sie unter Verknüpfungsaufrufe.

• Die maximale Größe, die Sie für die InternalBufferSize-Eigenschaft zum Überwachen eines Verzeichnisses über das Netzwerk festlegen können, beträgt 64 KB.

Hinweis
Die Ausführung von FileSystemWatcher unter Windows 98 wird nicht unterstützt.

Kopieren und Verschieben von Ordnern

Ereignisse und Puffergrößen

Im folgenden Beispiel wird ein FileSystemWatcher erstellt, mit dem das zur Laufzeit angegebene Verzeichnis überwacht wird. In der Komponente wird festgelegt, dass Textdateien im Verzeichnis auf Änderungen in Bezug auf die Uhrzeit von LastWrite und LastAccess sowie das Erstellen, Löschen oder Umbenennen überwacht werden. Beim Ändern, Erstellen oder Löschen einer Datei wird der Dateipfad an die Konsole ausgegeben. Beim Umbenennen einer Datei werden der alte und der neue Pfad an die Konsole ausgegeben.

Verwenden Sie für dieses Beispiel den System.Diagnostics-Namespace und den System.IO-Namespace.

using System;
using System.IO;
using System.Security.Permissions;

public class Watcher
{

    public static void Main()
    {
    Run();

    }

    [PermissionSet(SecurityAction.Demand, Name="FullTrust")]
    public static void Run()
    {
        string[] args = System.Environment.GetCommandLineArgs();

        // If a directory is not specified, exit program.
        if(args.Length != 2)
        {
            // Display the proper way to call the program.
            Console.WriteLine("Usage: Watcher.exe (directory)");
            return;
        }

        // Create a new FileSystemWatcher and set its properties.
        FileSystemWatcher watcher = new FileSystemWatcher();
        watcher.Path = args[1];
        /* Watch for changes in LastAccess and LastWrite times, and
           the renaming of files or directories. */
        watcher.NotifyFilter = NotifyFilters.LastAccess | NotifyFilters.LastWrite
           | NotifyFilters.FileName | NotifyFilters.DirectoryName;
        // Only watch text files.
        watcher.Filter = "*.txt";

        // Add event handlers.
        watcher.Changed += new FileSystemEventHandler(OnChanged);
        watcher.Created += new FileSystemEventHandler(OnChanged);
        watcher.Deleted += new FileSystemEventHandler(OnChanged);
        watcher.Renamed += new RenamedEventHandler(OnRenamed);

        // Begin watching.
        watcher.EnableRaisingEvents = true;

        // Wait for the user to quit the program.
        Console.WriteLine("Press \'q\' to quit the sample.");
        while(Console.Read()!='q');
    }

    // Define the event handlers.
    private static void OnChanged(object source, FileSystemEventArgs e)
    {
        // Specify what is done when a file is changed, created, or deleted.
       Console.WriteLine("File: " +  e.FullPath + " " + e.ChangeType);
    }

    private static void OnRenamed(object source, RenamedEventArgs e)
    {
        // Specify what is done when a file is renamed.
        Console.WriteLine("File: {0} renamed to {1}", e.OldFullPath, e.FullPath);
    }
}

.NET Framework

.NET Framework Client Profile

• SecurityPermission  

  zum Aufrufen von ProcessStartInfo-Membern. Anforderungswert: LinkDemand; Benannte Berechtigungssätze: FullTrust.

• SecurityPermission  

  zum Ableiten von der ProcessStartInfo-Klasse. Anforderungswert: InheritanceDemand; Benannte Berechtigungssätze: FullTrust.

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

Referenz