FileSystemWatcher.SynchronizingObject Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает объект, используемый для маршалинга вызовов обработчика событий, инициированных в результате изменения каталога.
public:
property System::ComponentModel::ISynchronizeInvoke ^ SynchronizingObject { System::ComponentModel::ISynchronizeInvoke ^ get(); void set(System::ComponentModel::ISynchronizeInvoke ^ value); };
public System.ComponentModel.ISynchronizeInvoke? SynchronizingObject { get; set; }
public System.ComponentModel.ISynchronizeInvoke SynchronizingObject { get; set; }
[System.IO.IODescription("FSW_SynchronizingObject")]
public System.ComponentModel.ISynchronizeInvoke SynchronizingObject { get; set; }
[System.IO.IODescription("FSW_SynchronizingObject")]
[System.ComponentModel.Browsable(false)]
public System.ComponentModel.ISynchronizeInvoke SynchronizingObject { get; set; }
[System.ComponentModel.Browsable(false)]
public System.ComponentModel.ISynchronizeInvoke SynchronizingObject { get; set; }
member this.SynchronizingObject : System.ComponentModel.ISynchronizeInvoke with get, set
[<System.IO.IODescription("FSW_SynchronizingObject")>]
member this.SynchronizingObject : System.ComponentModel.ISynchronizeInvoke with get, set
[<System.IO.IODescription("FSW_SynchronizingObject")>]
[<System.ComponentModel.Browsable(false)>]
member this.SynchronizingObject : System.ComponentModel.ISynchronizeInvoke with get, set
[<System.ComponentModel.Browsable(false)>]
member this.SynchronizingObject : System.ComponentModel.ISynchronizeInvoke with get, set
Public Property SynchronizingObject As ISynchronizeInvoke
Значение свойства
ISynchronizeInvoke, который описывает объект, используемый для маршалинга вызовов обработчика событий, инициированных в результате изменения каталога. Значение по умолчанию — null
.
- Атрибуты
Комментарии
Если SynchronizingObject имеет значение null
, методы, обрабатывая Changedсобытия , Created, Deletedи Renamed , вызываются в потоке из пула системных потоков. Дополнительные сведения о системных пулах потоков см. в разделе ThreadPool.
ChangedЕсли события , Created, Deletedи Renamed обрабатываются компонентом визуального Windows Forms, например Button, доступ к компоненту через пул системных потоков может не работать или может привести к исключению. Избежать этого, задав SynchronizingObject для Windows Forms компонент, что приводит к вызову методов, обрабатывающих Changedсобытия , Created, Deletedи Renamed , в том же потоке, в котором был создан компонент.
FileSystemWatcher Если используется в Visual Studio 2005 в конструкторе Windows Forms, SynchronizingObject автоматически задает для элемента управления , содержащего FileSystemWatcher. Например, если поместить FileSystemWatcher в конструктор для Form1 (который наследуется от Form), свойству SynchronizingObjectFileSystemWatcher присваивается экземпляр Form1.