Dispatcher.BeginInvoke メソッド

public:
 System::Windows::Threading::DispatcherOperation ^ BeginInvoke(Delegate ^ method, ... cli::array <System::Object ^> ^ args);

public System.Windows.Threading.DispatcherOperation BeginInvoke (Delegate method, params object[] args);

member this.BeginInvoke : Delegate * obj[] -> System.Windows.Threading.DispatcherOperation

Public Function BeginInvoke (method As Delegate, ParamArray args As Object()) As DispatcherOperation

パラメーター

戻り値

DispatcherOperation

BeginInvoke の呼び出し直後に返されるオブジェクト。このオブジェクトを使用して、イベント キューで実行が保留になっているデリゲートと対話できます。

注釈

返されるBeginInvokeオブジェクトはDispatcherOperation、次のような、指定したデリゲートとやり取りするいくつかの方法で使用できます。

• DispatcherPriorityイベント キューでの実行が保留中のデリゲートの変更。

• イベント キューからのデリゲートの削除。

• デリゲートが返されるのを待っている。

• デリゲートが実行された後に返される値を取得します。

BeginInvoke は非同期です。したがって、コントロールは呼び出し後すぐに呼び出し元のオブジェクトに戻ります。

WPF では、作成した DispatcherObject スレッドのみがそのオブジェクトにアクセスできます。 たとえば、メイン UI スレッドからスピンオフされたバックグラウンド スレッドは、UI スレッドで作成された内容 Button を更新できません。 バックグラウンド スレッドが Content プロパティ Buttonにアクセスするには、バックグラウンド スレッドが UI スレッドに関連付けられている作業を Dispatcher 委任する必要があります。 これは、どちらかInvokeBeginInvokeを使用して実現されます。 Invoke は同期であり、 BeginInvoke 非同期です。 操作は、指定した位置にあるイベント キューに Dispatcher 追加されます DispatcherPriority。

シャットダウンした状態でDispatcher呼び出された場合BeginInvoke、返されるDispatcherOperation状態プロパティは Aborted.

public:
 System::Windows::Threading::DispatcherOperation ^ BeginInvoke(System::Windows::Threading::DispatcherPriority priority, Delegate ^ method);

[System.ComponentModel.Browsable(false)]
public System.Windows.Threading.DispatcherOperation BeginInvoke (System.Windows.Threading.DispatcherPriority priority, Delegate method);

[<System.ComponentModel.Browsable(false)>]
member this.BeginInvoke : System.Windows.Threading.DispatcherPriority * Delegate -> System.Windows.Threading.DispatcherOperation

Public Function BeginInvoke (priority As DispatcherPriority, method As Delegate) As DispatcherOperation

パラメーター

戻り値

DispatcherOperation

BeginInvoke の呼び出し直後に返されるオブジェクト。このオブジェクトを使用して、イベント キューで実行が保留になっているデリゲートと対話できます。

属性

BrowsableAttribute

例外

例

次の例は、操作 Dispatcherを . この例の完全なソース コードについては、「 Long-Running計算サンプルを使用したシングル スレッド アプリケーション」を参照してください。

最初に、引数を受け取らないデリゲートが作成されます。

public delegate void NextPrimeDelegate();

Public Delegate Sub NextPrimeDelegate()

次に、 BeginInvoke(DispatcherPriority, Delegate) 呼び出されます。 すべてのDispatcherObjectプロパティは関連付けられているプロパティをDispatcher返すので、必要Dispatcherなプロパティは、この場合ButtonはDispatcherObject名前付き startStopButton. 呼び出し BeginInvoke(DispatcherPriority, Delegate) は、2 つのパラメーターを受け取ります。優先度は 、に DispatcherPriority.Normal設定され、コールバックはデリゲート NextPrimeDelegateのインスタンスを介して渡されます。

startStopButton.Dispatcher.BeginInvoke(
    DispatcherPriority.Normal,
    new NextPrimeDelegate(CheckNextNumber));

startStopButton.Dispatcher.BeginInvoke(DispatcherPriority.Normal, New NextPrimeDelegate(AddressOf CheckNextNumber))

注釈

複数の BeginInvoke 呼び出しが同じ DispatcherPriority場合、呼び出しが行われた順序で実行されます。

BeginInvoke は、 DispatcherOperation デリゲートがイベント キュー内にあるときにデリゲートとの対話に使用できるオブジェクトを返します。

返されるBeginInvokeオブジェクトはDispatcherOperation、次のような、指定したデリゲートとやり取りするいくつかの方法で使用できます。

• DispatcherPriorityイベント キューでの実行が保留中のデリゲートの変更。

• イベント キューからのデリゲートの削除。

• デリゲートが返されるのを待っている。

• デリゲートが実行された後に返される値を取得します。

BeginInvoke は非同期です。したがって、コントロールは呼び出し後すぐに呼び出し元のオブジェクトに戻ります。

WPF では、作成した DispatcherObject スレッドのみがそのオブジェクトにアクセスできます。 たとえば、メイン UI スレッドからスピンオフされたバックグラウンド スレッドは、UI スレッドで作成された内容 Button を更新できません。 バックグラウンド スレッドが Content プロパティ Buttonにアクセスするには、バックグラウンド スレッドが UI スレッドに関連付けられている作業を Dispatcher 委任する必要があります。 これは、どちらかInvokeBeginInvokeを使用して実現されます。 Invoke は同期であり、 BeginInvoke 非同期です。 操作は、指定した位置にあるイベント キューに Dispatcher 追加されます DispatcherPriority。

シャットダウンした状態でDispatcher呼び出された場合BeginInvoke、返されるDispatcherOperation状態プロパティは Aborted.

こちらもご覧ください

• 実行時間の長い計算を使用するシングルスレッド アプリケーションのサンプル

public:
 System::Windows::Threading::DispatcherOperation ^ BeginInvoke(Delegate ^ method, System::Windows::Threading::DispatcherPriority priority, ... cli::array <System::Object ^> ^ args);

public System.Windows.Threading.DispatcherOperation BeginInvoke (Delegate method, System.Windows.Threading.DispatcherPriority priority, params object[] args);

member this.BeginInvoke : Delegate * System.Windows.Threading.DispatcherPriority * obj[] -> System.Windows.Threading.DispatcherOperation

Public Function BeginInvoke (method As Delegate, priority As DispatcherPriority, ParamArray args As Object()) As DispatcherOperation

パラメーター

戻り値

DispatcherOperation

BeginInvoke の呼び出し直後に返されるオブジェクト。このオブジェクトを使用して、イベント キューで実行が保留になっているデリゲートと対話できます。

注釈

返されるBeginInvokeオブジェクトはDispatcherOperation、次のような、指定したデリゲートとやり取りするいくつかの方法で使用できます。

• DispatcherPriorityイベント キューでの実行が保留中のデリゲートの変更。

• イベント キューからのデリゲートの削除。

• デリゲートが返されるのを待っている。

• デリゲートが実行された後に返される値を取得します。

BeginInvoke は非同期です。したがって、コントロールは呼び出し後すぐに呼び出し元のオブジェクトに戻ります。

WPF では、作成した DispatcherObject スレッドのみがそのオブジェクトにアクセスできます。 たとえば、メイン UI スレッドからスピンオフされたバックグラウンド スレッドは、UI スレッドで作成された内容 Button を更新できません。 バックグラウンド スレッドが Content プロパティ Buttonにアクセスするには、バックグラウンド スレッドが UI スレッドに関連付けられている作業を委任する Dispatcher 必要があります。 これは、どちらかをInvokeBeginInvoke使用して行います。 Invoke は同期であり、 BeginInvoke 非同期です。 操作は、指定した位置のイベント キューに Dispatcher 追加されます DispatcherPriority。

シャットダウンした状態でDispatcher呼び出された場合BeginInvoke、返されるDispatcherOperation状態プロパティは Aborted.

public:
 System::Windows::Threading::DispatcherOperation ^ BeginInvoke(System::Windows::Threading::DispatcherPriority priority, Delegate ^ method, System::Object ^ arg);

[System.ComponentModel.Browsable(false)]
public System.Windows.Threading.DispatcherOperation BeginInvoke (System.Windows.Threading.DispatcherPriority priority, Delegate method, object arg);

[<System.ComponentModel.Browsable(false)>]
member this.BeginInvoke : System.Windows.Threading.DispatcherPriority * Delegate * obj -> System.Windows.Threading.DispatcherOperation

Public Function BeginInvoke (priority As DispatcherPriority, method As Delegate, arg As Object) As DispatcherOperation

パラメーター

戻り値

DispatcherOperation

BeginInvoke の呼び出し直後に返されるオブジェクト。このオブジェクトを使用して、イベント キューで実行が保留になっているデリゲートと対話できます。

属性

BrowsableAttribute

例外

例

次の例は、操作 Dispatcherを .

まず、1 つの引数 (この場合は文字列) を受け取るデリゲートが作成されます。

private delegate void OneArgDelegate(String arg);

Private Delegate Sub OneArgDelegate(ByVal arg As String)

次に、 BeginInvoke(DispatcherPriority, Delegate, Object) 呼び出されます。 すべてのDispatcherObjectプロパティに関連付けられているプロパティが含Dispatcherまれているため、目的Dispatcherのプロパティは 、この場合GridはDispatcherObject名前付き tomorrowsWeather. 呼び出し BeginInvoke(DispatcherPriority, Delegate, Object) は 3 つのパラメーターを受け取ります。優先度は DispatcherPriority.Normal、デリゲート OneArgDelegateのインスタンスを介して渡されるコールバックと、コールバックの引数である名前付きの weather文字列です。

// Schedule the update function in the UI thread.
tomorrowsWeather.Dispatcher.BeginInvoke(
    System.Windows.Threading.DispatcherPriority.Normal,
    new OneArgDelegate(UpdateUserInterface), 
    weather);

' Schedule the update function in the UI thread.
tomorrowsWeather.Dispatcher.BeginInvoke(System.Windows.Threading.DispatcherPriority.Normal, New OneArgDelegate(AddressOf UpdateUserInterface), weather)

注釈

arg は、 null 引数が必要ない場合に使用できます。

BeginInvoke は、 DispatcherOperation デリゲートがイベント キュー内にある場合にデリゲートと対話するために使用できるオブジェクトを返します。

返されるBeginInvokeオブジェクトはDispatcherOperation、次のように、指定したデリゲートと対話するためにいくつかの方法で使用できます。

• DispatcherPriorityイベント キューでの保留中のデリゲートの変更。

• イベント キューからデリゲートを削除します。

• デリゲートが返されるのを待っている。

• デリゲートが実行された後に返される値を取得します。

BeginInvoke は非同期です。したがって、コントロールは呼び出された直後に呼び出し元のオブジェクトに戻ります。

WPF では、作成したスレッドのみがそのオブジェクトに DispatcherObject アクセスできます。 たとえば、メイン UI スレッドからスピンオフされたバックグラウンド スレッドは、UI スレッドで作成された内容 Button を更新できません。 バックグラウンド スレッドがコンテンツ プロパティ Buttonにアクセスするには、バックグラウンド スレッドが UI スレッドに関連付けられている作業を委任する Dispatcher 必要があります。 これは、どちらかをInvokeBeginInvoke使用して行います。 Invoke は同期であり、 BeginInvoke 非同期です。 操作は、指定した位置のイベント キューに Dispatcher 追加されます DispatcherPriority。

複数の BeginInvoke 呼び出しが同じ DispatcherPriorityで行われる場合は、呼び出しが行われた順序で実行されます。

シャットダウンした状態でDispatcher呼び出された場合BeginInvoke、返されるDispatcherOperation状態プロパティは Aborted.

こちらもご覧ください

• 実行時間の長い計算を使用するシングルスレッド アプリケーションのサンプル

public:
 System::Windows::Threading::DispatcherOperation ^ BeginInvoke(System::Windows::Threading::DispatcherPriority priority, Delegate ^ method, System::Object ^ arg, ... cli::array <System::Object ^> ^ args);

[System.ComponentModel.Browsable(false)]
public System.Windows.Threading.DispatcherOperation BeginInvoke (System.Windows.Threading.DispatcherPriority priority, Delegate method, object arg, params object[] args);

[<System.ComponentModel.Browsable(false)>]
member this.BeginInvoke : System.Windows.Threading.DispatcherPriority * Delegate * obj * obj[] -> System.Windows.Threading.DispatcherOperation

Public Function BeginInvoke (priority As DispatcherPriority, method As Delegate, arg As Object, ParamArray args As Object()) As DispatcherOperation

パラメーター

戻り値

DispatcherOperation

BeginInvoke の呼び出し直後に返されるオブジェクト。このオブジェクトを使用して、Dispatcher キューで実行が保留になっているデリゲートと対話できます。

属性

BrowsableAttribute

例外

注釈

引数が arg 必要ない場合は、パラメーターを指定できます null 。

BeginInvoke は、 DispatcherOperation デリゲートがイベント キュー内にある場合にデリゲートと対話するために使用できるオブジェクトを返します。

返されるBeginInvokeオブジェクトはDispatcherOperation、次のように、指定したデリゲートと対話するためにいくつかの方法で使用できます。

• DispatcherPriorityイベント キューでの保留中のデリゲートの変更。

• イベント キューからデリゲートを削除します。

• デリゲートが返されるのを待っている。

• デリゲートが実行された後に返される値を取得します。

BeginInvoke は非同期です。したがって、コントロールは呼び出された直後に呼び出し元のオブジェクトに戻ります。

WPF では、作成したスレッドのみがそのオブジェクトに DispatcherObject アクセスできます。 たとえば、メイン UI スレッドからスピンオフされたバックグラウンド スレッドは、UI スレッドで作成された内容 Button を更新できません。 バックグラウンド スレッドが Content プロパティ Buttonにアクセスするには、バックグラウンド スレッドが UI スレッドに関連付けられている作業を委任する Dispatcher 必要があります。 これは、どちらかをInvokeBeginInvoke使用して行います。 Invoke は同期であり、 BeginInvoke 非同期です。 操作は、指定した位置のイベント キューに Dispatcher 追加されます DispatcherPriority。

複数の BeginInvoke 呼び出しが同じ DispatcherPriorityで行われる場合は、呼び出しが行われた順序で実行されます。

シャットダウンした状態でDispatcher呼び出された場合BeginInvoke、返されるDispatcherOperation状態プロパティは Aborted.

こちらもご覧ください

• 実行時間の長い計算を使用するシングルスレッド アプリケーションのサンプル