FileSystemWatcher.SynchronizingObject Właściwość

Definicja

Pobiera lub ustawia obiekt używany do organizowania wywołań obsługi zdarzeń, który został wygenerowany w wyniku zmiany katalogu.Gets or sets the object used to marshal the event handler calls issued as a result of a directory change.

public:
 property System::ComponentModel::ISynchronizeInvoke ^ SynchronizingObject { System::ComponentModel::ISynchronizeInvoke ^ get(); void set(System::ComponentModel::ISynchronizeInvoke ^ value); };
[System.ComponentModel.Browsable(false)]
[System.IO.IODescription("The object used to marshal the event handler calls resulting from a directory change")]
[System.IO.IODescription("FSW_SynchronizingObject")]
public System.ComponentModel.ISynchronizeInvoke SynchronizingObject { get; set; }
member this.SynchronizingObject : System.ComponentModel.ISynchronizeInvoke with get, set
Public Property SynchronizingObject As ISynchronizeInvoke

Wartość właściwości

ISynchronizeInvoke reprezentujący obiekt służący do organizowania wywołań obsługi zdarzeń, który został wygenerowany w wyniku zmiany katalogu.The ISynchronizeInvoke that represents the object used to marshal the event handler calls issued as a result of a directory change. Wartość domyślna to null.The default is null.

Atrybuty

Uwagi

Gdy SynchronizingObject jest null, metody obsługujące zdarzenia Changed, Created, Deletedi Renamed są wywoływane w wątku z puli wątków systemowych.When SynchronizingObject is null, methods handling the Changed, Created, Deleted, and Renamed events are called on a thread from the system thread pool. Aby uzyskać więcej informacji na temat pul wątków systemowych, zobacz ThreadPool.For more information on system thread pools, see ThreadPool.

Gdy zdarzenia Changed, Created, Deletedi Renamed są obsługiwane przez składnik Windows Forms wizualny, na przykład Button, dostęp do składnika za pomocą puli wątków systemowych może nie być zadziałały lub może to spowodować wyjątek.When the Changed, Created, Deleted, and Renamed events are handled by a visual Windows Forms component, such as a Button, accessing the component through the system thread pool might not work, or may result in an exception. Można to uniknąć przez ustawienie SynchronizingObject do składnika Windows Forms, co powoduje, że metody obsługujące Changed, Created, Deletedi Renamed zdarzenia mają być wywoływane w tym samym wątku, w którym został utworzony składnik.Avoid this by setting SynchronizingObject to a Windows Forms component, which causes the methods that handle the Changed, Created, Deleted, and Renamed events to be called on the same thread on which the component was created.

Jeśli FileSystemWatcher jest używana wewnątrz Visual Studio 2005Visual Studio 2005 w projektancie Windows Forms, SynchronizingObject automatycznie ustawia do kontrolki zawierającej FileSystemWatcher.If the FileSystemWatcher is used inside Visual Studio 2005Visual Studio 2005 in a Windows Forms designer, SynchronizingObject automatically sets to the control that contains the FileSystemWatcher. Na przykład jeśli umieścisz FileSystemWatcher w projektancie dla formularza Form1 (który dziedziczy z Form) Właściwość SynchronizingObject FileSystemWatcher jest ustawiona na wystąpienie formularza Form1.For example, if you place a FileSystemWatcher on a designer for Form1 (which inherits from Form) the SynchronizingObject property of FileSystemWatcher is set to the instance of Form1.

Dotyczy

Zobacz też