FileSystemWatcher Constructeurs
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Initialise une nouvelle instance de la classe FileSystemWatcher.
Surcharges
| Nom | Description |
|---|---|
| FileSystemWatcher() |
Initialise une nouvelle instance de la classe FileSystemWatcher. |
| FileSystemWatcher(String) |
Initialise une nouvelle instance de la FileSystemWatcher classe, en fonction du répertoire spécifié à surveiller. |
| FileSystemWatcher(String, String) |
Initialise une nouvelle instance de la FileSystemWatcher classe, en fonction du répertoire et du type de fichiers spécifiés à surveiller. |
FileSystemWatcher()
- Source:
- FileSystemWatcher.cs
- Source:
- FileSystemWatcher.cs
- Source:
- FileSystemWatcher.cs
- Source:
- FileSystemWatcher.cs
- Source:
- FileSystemWatcher.cs
Initialise une nouvelle instance de la classe FileSystemWatcher.
public:
FileSystemWatcher();
public FileSystemWatcher();
Public Sub New ()
Exemples
L’exemple suivant crée un FileSystemWatcher objet pour surveiller le répertoire spécifié au moment de l’exécution. L’objet FileSystemWatcher surveille les modifications et LastAccessLastWrite les heures, ainsi que la création, la suppression ou le renommage des fichiers texte dans le répertoire. Si un fichier est modifié, créé ou supprimé, le chemin d’accès au fichier s’affiche dans la console. Lorsqu’un fichier est renommé, les anciens chemins d’accès s’affichent sur la console.
Cet exemple utilise les espaces de noms et System.IO les System.Diagnostics espaces de noms.
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
Remarques
Vous ne pouvez pas regarder un ordinateur distant qui n’a pas Windows NT ou Windows 2000. Vous ne pouvez pas regarder un ordinateur Windows NT 4.0 distant à partir d’un ordinateur Windows NT 4.0.
Le tableau suivant présente les valeurs de propriété initiales d’une instance de FileSystemWatcher.
| Propriété | Valeur initiale |
|---|---|
| NotifyFilter | combinaison OR au niveau du bit de LastWrite, FileNameet DirectoryName |
| EnableRaisingEvents | false |
| Filter | « *.* » (Regardez tous les fichiers.) |
| IncludeSubdirectories | false |
| InternalBufferSize | 8192 |
| Path | chaîne vide (« ») |
Note
Le composant ne surveille pas le répertoire spécifié tant que l’objet Path n’est pas défini et EnableRaisingEvents qu’il est true.
Voir aussi
- NotifyFilters
- FileSystemEventArgs
- FileSystemEventHandler
- InternalBufferOverflowException
- Path
- RenamedEventArgs
- RenamedEventHandler
- WaitForChangedResult
- WatcherChangeTypes
S’applique à
FileSystemWatcher(String)
- Source:
- FileSystemWatcher.cs
- Source:
- FileSystemWatcher.cs
- Source:
- FileSystemWatcher.cs
- Source:
- FileSystemWatcher.cs
- Source:
- FileSystemWatcher.cs
Initialise une nouvelle instance de la FileSystemWatcher classe, en fonction du répertoire spécifié à surveiller.
public:
FileSystemWatcher(System::String ^ path);
public FileSystemWatcher(string path);
new System.IO.FileSystemWatcher : string -> System.IO.FileSystemWatcher
Public Sub New (path As String)
Paramètres
- path
- String
Répertoire à surveiller, en notation UNC (Universal Naming Convention) standard ou Universelle.
Exceptions
Le path paramètre est null.
Le path paramètre est une chaîne vide (« »).
- ou -
Le chemin d’accès spécifié via le path paramètre n’existe pas.
path est trop long.
Remarques
Note
Le composant ne surveille pas le répertoire spécifié tant que l’objet Path n’est pas défini et EnableRaisingEvents qu’il est true.
Le composant peut surveiller les fichiers sur votre ordinateur personnel, un lecteur réseau ou un ordinateur distant.
Vous ne pouvez pas regarder un ordinateur distant qui n’a pas Windows NT ou Windows 2000. Vous ne pouvez pas regarder un ordinateur Windows NT 4.0 distant à partir d’un ordinateur Windows NT 4.0. La Filter propriété est définie par défaut pour surveiller tous les fichiers.
Voir aussi
- NotifyFilters
- FileSystemEventArgs
- FileSystemEventHandler
- Filter
- InternalBufferOverflowException
- Path
- RenamedEventArgs
- RenamedEventHandler
- WaitForChangedResult
- WatcherChangeTypes
S’applique à
FileSystemWatcher(String, String)
- Source:
- FileSystemWatcher.cs
- Source:
- FileSystemWatcher.cs
- Source:
- FileSystemWatcher.cs
- Source:
- FileSystemWatcher.cs
- Source:
- FileSystemWatcher.cs
Initialise une nouvelle instance de la FileSystemWatcher classe, en fonction du répertoire et du type de fichiers spécifiés à surveiller.
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)
Paramètres
- path
- String
Répertoire à surveiller, en notation UNC (Universal Naming Convention) standard ou Universelle.
- filter
- String
Type de fichiers à surveiller. Par exemple, « *.txt» surveille les modifications apportées à tous les fichiers texte.
Exceptions
Le path paramètre est une chaîne vide (« »).
- ou -
Le chemin d’accès spécifié via le path paramètre n’existe pas.
path est trop long.
Remarques
Note
Le composant ne surveille pas le répertoire spécifié tant que l’objet Path n’est pas défini et EnableRaisingEvents qu’il est true.
Le composant peut surveiller les fichiers sur votre ordinateur personnel, un lecteur réseau ou un ordinateur distant.
Vous ne pouvez pas regarder un ordinateur distant qui n’a pas Windows NT ou Windows 2000. Vous ne pouvez pas regarder un ordinateur Windows NT 4.0 distant à partir d’un ordinateur Windows NT 4.0.
Voir aussi
- NotifyFilters
- FileSystemEventArgs
- FileSystemEventHandler
- Filter
- InternalBufferOverflowException
- Path
- RenamedEventArgs
- RenamedEventHandler
- WaitForChangedResult
- WatcherChangeTypes