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; }
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; }
[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
[<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
[<System.ComponentModel.Browsable(false)>]
[<System.IO.IODescription("The object used to marshal the event handler calls resulting from a directory change")>]
member this.SynchronizingObject : System.ComponentModel.ISynchronizeInvoke with get, set
Public Property SynchronizingObject As ISynchronizeInvoke

プロパティ値

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

、、 Changed Created 、およびの各 Deleted 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. これを回避するには、を Windows フォームコンポーネントに設定します。これにより、、、 SynchronizingObject 、およびの各イベントを処理するメソッドが、コンポーネントが作成さ Changed れたのと Created 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.

FileSystemWatcherが Windows フォームデザイナーで Visual Studio 2005 内で使用されている場合、はを SynchronizingObject 含むコントロールにを自動的に設定し FileSystemWatcher ます。If the FileSystemWatcher is used inside Visual 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.

適用対象

こちらもご覧ください