FileSystemWatcher.SynchronizingObject FileSystemWatcher.SynchronizingObject FileSystemWatcher.SynchronizingObject FileSystemWatcher.SynchronizingObject Property

定義

ディレクトリ変更の結果として発行されるイベント ハンドラー呼び出しをマーシャリングするために使用するオブジェクトを取得または設定します。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

プロパティ値

ディレクトリ変更の結果として発行されるイベント ハンドラー呼び出しをマーシャリングするために使用するオブジェクトを表す ISynchronizeInvokeThe ISynchronizeInvoke that represents the object used to marshal the event handler calls issued as a result of a directory change. 既定値は、null です。The default is null.

注釈

SynchronizingObject Changedの場合Created、、、 Deleted、およびの各イベントを処理するメソッドは、システムスレッドプールからのスレッドで呼び出されます。Renamed nullWhen SynchronizingObject is null, methods handling the Changed, Created, Deleted, and Renamed events are called on a thread from the system thread pool. システムスレッドプールの詳細についてはThreadPool、「」を参照してください。For more information on system thread pools, see ThreadPool.

Changed Button、、、およびRenamedの各イベントが、などのビジュアル Windows フォームコンポーネントによって処理される場合、システムスレッドプールを介してコンポーネントにアクセスしても動作しない可能性があります。または、例外が発生する可能性があります。 Deleted CreatedWhen 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. これを回避するSynchronizingObjectには、を Windows フォームコンポーネントに設定します。これChangedCreatedよりDeleted、、 Renamed 、、およびの各イベントを処理するメソッドが、コンポーネントが作成されたのと同じスレッドで呼び出されます。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.

が Windows フォームデザイナーの内部Visual Studio 2005Visual Studio 2005で使用されてSynchronizingObjectいる場合、はを含むコントロールにFileSystemWatcherを自動的に設定します。 FileSystemWatcherIf 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. たとえば、をFileSystemWatcher form1 のデザイナー (からForm継承) SynchronizingObjectに配置すると、のFileSystemWatcherプロパティは、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.

適用対象

こちらもご覧ください