FileSystemWatcher.SynchronizingObject プロパティ

定義

ディレクトリ変更の結果として発行されるイベント ハンドラー呼び出しをマーシャリングするために使用するオブジェクトを取得または設定します。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); };
public System.ComponentModel.ISynchronizeInvoke SynchronizingObject { get; set; }
[System.IO.IODescription("FSW_SynchronizingObject")]
public System.ComponentModel.ISynchronizeInvoke SynchronizingObject { get; set; }
[System.ComponentModel.Browsable(false)]
[System.IO.IODescription("FSW_SynchronizingObject")]
public System.ComponentModel.ISynchronizeInvoke SynchronizingObject { get; set; }
[System.ComponentModel.Browsable(false)]
public System.ComponentModel.ISynchronizeInvoke SynchronizingObject { get; set; }
[System.ComponentModel.Browsable(false)]
[System.IO.IODescription("The object used to marshal the event handler calls resulting from a directory change")]
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.

属性

注釈

SynchronizingObjectnull場合、ChangedCreatedDeleted、および Renamed の各イベントを処理するメソッドは、システムスレッドプールからのスレッドで呼び出されます。When 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.

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

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

適用対象

こちらもご覧ください