FileSystemWatcher.EnableRaisingEvents 속성

정의

구성 요소가 활성화되는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the component is enabled.

public:
 property bool EnableRaisingEvents { bool get(); void set(bool value); };
public bool EnableRaisingEvents { get; set; }
[System.IO.IODescription("FSW_Enabled")]
public bool EnableRaisingEvents { get; set; }
[System.IO.IODescription("Flag to indicate if this instance is active")]
public bool EnableRaisingEvents { get; set; }
member this.EnableRaisingEvents : bool with get, set
[<System.IO.IODescription("FSW_Enabled")>]
member this.EnableRaisingEvents : bool with get, set
[<System.IO.IODescription("Flag to indicate if this instance is active")>]
member this.EnableRaisingEvents : bool with get, set
Public Property EnableRaisingEvents As Boolean

속성 값

Boolean

구성 요소가 활성화되면 true이고, 그렇지 않으면 false입니다.true if the component is enabled; otherwise, false. 기본값은 false입니다.The default is false. Visual Studio 2005Visual Studio 2005의 디자이너에서 구성 요소를 사용하고 있으면 기본값은 true입니다.If you are using the component on a designer in Visual Studio 2005Visual Studio 2005, the default is true.

특성

예외

FileSystemWatcher 개체가 삭제되었습니다.The FileSystemWatcher object has been disposed.

현재 운영 체제가 Microsoft Windows NT 이상이 아닙니다.The current operating system is not Microsoft Windows NT or later.

Path에 지정된 디렉터리를 찾을 수 없는 경우The directory specified in Path could not be found.

Path가 설정되지 않았거나 잘못된 경우Path has not been set or is invalid.

예제

다음 예제에서는를 만들어 FileSystemWatcher 런타임에 지정 된 디렉터리를 시청 합니다.The following example creates a FileSystemWatcher to watch the directory specified at run time. 구성 요소는 LastWrite LastAccess 디렉터리에 있는 텍스트 파일의 생성, 삭제 또는 이름 바꾸기와 시간에 대 한 변경 내용을 감시 하도록 설정 되어 있습니다.The component is set to watch for changes in LastWrite and LastAccess time, the creation, deletion, or renaming of text files in the directory. 파일이 변경, 생성 또는 삭제 되는 경우 파일의 경로는 콘솔에 출력 됩니다.If a file is changed, created, or deleted, the path to the file prints to the console. 파일의 이름을 바꾸면 이전 경로와 새 경로를 콘솔에 출력 합니다.When a file is renamed, the old and new paths print to the console.

#using <System.dll>

using namespace System;
using namespace System::IO;
using namespace System::Security::Permissions;

public ref class Watcher
{
private:
   // Define the event handlers.
   static void OnChanged( Object^ /*source*/, FileSystemEventArgs^ e )
   {
      // Specify what is done when a file is changed, created, or deleted.
      Console::WriteLine( "File: {0} {1}", e->FullPath, e->ChangeType );
   }

   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 );
   }

public:
   [PermissionSet(SecurityAction::Demand, Name="FullTrust")]
   int static run()
   {
      array<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 0;
      }

      // Create a new FileSystemWatcher and set its properties.
      FileSystemWatcher^ watcher = gcnew FileSystemWatcher;
      watcher->Path = args[ 1 ];

      /* Watch for changes in LastAccess and LastWrite times, and 
          the renaming of files or directories. */
      watcher->NotifyFilter = static_cast<NotifyFilters>(NotifyFilters::LastAccess |
            NotifyFilters::LastWrite | NotifyFilters::FileName | NotifyFilters::DirectoryName);

      // Only watch text files.
      watcher->Filter = "*.txt";

      // Add event handlers.
      watcher->Changed += gcnew FileSystemEventHandler( Watcher::OnChanged );
      watcher->Created += gcnew FileSystemEventHandler( Watcher::OnChanged );
      watcher->Deleted += gcnew FileSystemEventHandler( Watcher::OnChanged );
      watcher->Renamed += gcnew RenamedEventHandler( Watcher::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' );

      return 0;
   }
};

int main() {
   Watcher::run();
}
using System;
using System.IO;
using System.Security.Permissions;

public class Watcher
{
    public static void Main()
    {
        Run();
    }

    [PermissionSet(SecurityAction.Demand, Name = "FullTrust")]
    private static void Run()
    {
        string[] args = 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.
        using (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 += OnChanged;
            watcher.Created += OnChanged;
            watcher.Deleted += OnChanged;
            watcher.Renamed += 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: {e.OldFullPath} renamed to {e.FullPath}");
}
Imports System.IO
Imports System.Security.Permissions

Public Class Watcher

    Public Shared Sub Main()

        Run()

    End Sub

    <PermissionSet(SecurityAction.Demand, Name:="FullTrust")>
    Private Shared Sub Run()

        Dim args() As String = Environment.GetCommandLineArgs()

        ' If a directory is not specified, exit the program.
        If args.Length <> 2 Then
            ' Display the proper way to call the program.
            Console.WriteLine("Usage: Watcher.exe (directory)")
            Return
        End If

        ' Create a new FileSystemWatcher and set its properties.
        Using watcher As 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 _
                                 Or NotifyFilters.LastWrite _
                                 Or NotifyFilters.FileName _
                                 Or NotifyFilters.DirectoryName)

            ' Only watch text files.
            watcher.Filter = "*.txt"

            ' Add event handlers.
            AddHandler watcher.Changed, AddressOf OnChanged
            AddHandler watcher.Created, AddressOf OnChanged
            AddHandler watcher.Deleted, AddressOf OnChanged
            AddHandler watcher.Renamed, AddressOf OnRenamed

            ' Begin watching.
            watcher.EnableRaisingEvents = True

            ' Wait for the user to quit the program.
            Console.WriteLine("Press 'q' to quit the sample.")
            While Chr(Console.Read()) <> "q"c
            End While
        End Using
    End Sub

    ' Define the event handlers.
    Private Shared Sub OnChanged(source As Object, e As FileSystemEventArgs)
        ' Specify what is done when a file is changed, created, or deleted.
        Console.WriteLine($"File: {e.FullPath} {e.ChangeType}")
    End Sub

    Private Shared Sub OnRenamed(source As Object, e As RenamedEventArgs)
        ' Specify what is done when a file is renamed.
        Console.WriteLine($"File: {e.OldFullPath} renamed to {e.FullPath}")
    End Sub

End Class

설명

를로 설정 하지 않으면 구성 요소에서 이벤트를 발생 시 키 지 않습니다 EnableRaisingEvents true .The component will not raise events unless you set EnableRaisingEvents to true.

참고

Path속성이 설정 되 고가 인 경우에만 구성 요소가 지정 된 디렉터리를 감시 하지 않습니다 EnableRaisingEvents true .The component will not watch the specified directory until the Path property has been set and EnableRaisingEvents is true.

WaitForChanged메서드를 사용 하면이 속성이로 설정 된 경우에도 이벤트 처리기를 호출 하 여 파일 변경 내용에 응답할 수 있습니다 false .The WaitForChanged method allows event handlers to be invoked to respond to file changes even if this property is set to false.

적용 대상