FileSystemWatcher Costruttori

Riferimento

Definizione

Spazio dei nomi:: System.IO

Assembly:: System.IO.FileSystem.Watcher.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Inizializza una nuova istanza della classe FileSystemWatcher.

Overload

FileSystemWatcher()	Inizializza una nuova istanza della classe FileSystemWatcher.
FileSystemWatcher(String)	Inizializza una nuova istanza della classe FileSystemWatcher, una volta specificata la directory da monitorare.
FileSystemWatcher(String, String)	Inizializza una nuova istanza della classe FileSystemWatcher, una volta specificati la directory e il tipo di file da monitorare.

FileSystemWatcher()

Inizializza una nuova istanza della classe FileSystemWatcher.

public:
 FileSystemWatcher();

public FileSystemWatcher ();

Public Sub New ()

Esempio

Nell'esempio seguente viene creato un FileSystemWatcher oggetto per controllare la directory specificata in fase di esecuzione. L'oggetto FileSystemWatcher controlla le modifiche in LastWrite e LastAccess i tempi e per la creazione, l'eliminazione o la ridenominazione dei file di testo nella directory. Se un file viene modificato, creato o eliminato, il percorso del file viene visualizzato nella console. Quando un file viene rinominato, i percorsi precedenti e nuovi vengono visualizzati nella console.

In questo esempio vengono usati gli System.Diagnostics spazi dei nomi e System.IO .

#include "pch.h"

using namespace System;
using namespace System::IO;

class MyClassCPP
{
public:

    int static Run()
    {
        FileSystemWatcher^ watcher = gcnew FileSystemWatcher("C:\\path\\to\\folder");

        watcher->NotifyFilter = static_cast<NotifyFilters>(NotifyFilters::Attributes
                                                         | NotifyFilters::CreationTime
                                                         | NotifyFilters::DirectoryName
                                                         | NotifyFilters::FileName
                                                         | NotifyFilters::LastAccess
                                                         | NotifyFilters::LastWrite
                                                         | NotifyFilters::Security
                                                         | NotifyFilters::Size);

        watcher->Changed += gcnew FileSystemEventHandler(MyClassCPP::OnChanged);
        watcher->Created += gcnew FileSystemEventHandler(MyClassCPP::OnCreated);
        watcher->Deleted += gcnew FileSystemEventHandler(MyClassCPP::OnDeleted);
        watcher->Renamed += gcnew RenamedEventHandler(MyClassCPP::OnRenamed);
        watcher->Error   += gcnew ErrorEventHandler(MyClassCPP::OnError);

        watcher->Filter = "*.txt";
        watcher->IncludeSubdirectories = true;
        watcher->EnableRaisingEvents = true;

        Console::WriteLine("Press enter to exit.");
        Console::ReadLine();

        return 0;
    }

private:

    static void OnChanged(Object^ sender, FileSystemEventArgs^ e)
    {
        if (e->ChangeType != WatcherChangeTypes::Changed)
        {
            return;
        }
        Console::WriteLine("Changed: {0}", e->FullPath);
    }

    static void OnCreated(Object^ sender, FileSystemEventArgs^ e)
    {
        Console::WriteLine("Created: {0}", e->FullPath);
    }

    static void OnDeleted(Object^ sender, FileSystemEventArgs^ e)
    {
        Console::WriteLine("Deleted: {0}", e->FullPath);
    }

    static void OnRenamed(Object^ sender, RenamedEventArgs^ e)
    {
        Console::WriteLine("Renamed:");
        Console::WriteLine("    Old: {0}", e->OldFullPath);
        Console::WriteLine("    New: {0}", e->FullPath);
    }

    static void OnError(Object^ sender, ErrorEventArgs^ e)
    {
        PrintException(e->GetException());
    }

    static void PrintException(Exception^ ex)
    {
        if (ex != nullptr)
        {
            Console::WriteLine("Message: {0}", ex->Message);
            Console::WriteLine("Stacktrace:");
            Console::WriteLine(ex->StackTrace);
            Console::WriteLine();
            PrintException(ex->InnerException);
        }
    }
};


int main()
{
    MyClassCPP::Run();
}

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

Commenti

Non è possibile guardare un computer remoto che non ha Windows NT o Windows 2000. Non è possibile guardare un computer Windows NT 4.0 remoto da un computer Windows NT 4.0.

Nella tabella seguente vengono illustrati i valori delle proprietà iniziali per un'istanza di FileSystemWatcher.

Proprietà	Valore iniziale
NotifyFilter	combinazione OR bit per bit di `LastWrite`, `FileName`e `DirectoryName`
EnableRaisingEvents	`false`
Filter	"." Guardare tutti i file.
IncludeSubdirectories	`false`
InternalBufferSize	8192
Path	stringa vuota ("")

Nota

Il componente non controlla la directory specificata fino a quando non Path viene impostato ed EnableRaisingEvents è true.

Vedi anche

Si applica a

FileSystemWatcher(String)

Inizializza una nuova istanza della classe FileSystemWatcher, una volta specificata la directory da monitorare.

public:
 FileSystemWatcher(System::String ^ path);

public FileSystemWatcher (string path);

new System.IO.FileSystemWatcher : string -> System.IO.FileSystemWatcher

Public Sub New (path As String)

Parametri

path: String

Directory da monitorare, nella notazione standard o UNC (Universal Naming Convention).

Eccezioni

ArgumentNullException

Il valore del parametro path è null.

ArgumentException

Il parametro path è una stringa vuota ("").

-oppure- Il percorso specificato mediante il parametro path è inesistente.

PathTooLongException

path è troppo lungo.

Commenti

Nota

Il componente non controlla la directory specificata fino a quando non Path viene impostato ed EnableRaisingEvents è true.

Il componente può controllare i file nel computer personale, un'unità di rete o un computer remoto.

Non è possibile guardare un computer remoto che non ha Windows NT o Windows 2000. Non è possibile guardare un computer Windows NT 4.0 remoto da un computer Windows NT 4.0. La Filter proprietà è impostata per impostazione predefinita per controllare tutti i file.

Vedi anche

Si applica a

FileSystemWatcher(String, String)

Inizializza una nuova istanza della classe FileSystemWatcher, una volta specificati la directory e il tipo di file da monitorare.

public:
 FileSystemWatcher(System::String ^ path, System::String ^ filter);

public FileSystemWatcher (string path, string filter);

new System.IO.FileSystemWatcher : string * string -> System.IO.FileSystemWatcher

Public Sub New (path As String, filter As String)

Parametri

path: String

Directory da monitorare, nella notazione standard o UNC (Universal Naming Convention).

filter: String

Tipo di file da controllare. Ad esempio, "*.txt" controlla le modifiche apportate a tutti i file di testo.

Eccezioni

ArgumentNullException

Il valore del parametro path è null.

-oppure- Il valore del parametro filter è null.

ArgumentException

Il parametro path è una stringa vuota ("").

-oppure- Il percorso specificato mediante il parametro path è inesistente.

PathTooLongException

path è troppo lungo.

Commenti

Nota

Il componente non controlla la directory specificata fino a quando non Path viene impostato ed EnableRaisingEvents è true.

Il componente può controllare i file nel computer personale, un'unità di rete o un computer remoto.

Non è possibile guardare un computer remoto che non ha Windows NT o Windows 2000. Non è possibile guardare un computer Windows NT 4.0 remoto da un computer Windows NT 4.0.

Vedi anche

Si applica a

FileSystemWatcher Costruttori

Definizione

Overload

FileSystemWatcher()

Esempio

Commenti

Vedi anche

Si applica a

FileSystemWatcher(String)

Parametri

Eccezioni

Commenti

Vedi anche

Si applica a

FileSystemWatcher(String, String)

Parametri

Eccezioni

Commenti

Vedi anche

Si applica a

Risorse aggiuntive