DispatcherPriority DispatcherPriority DispatcherPriority DispatcherPriority Enum

定義

Dispatcher での処理呼び出しの優先順位を示します。Describes the priorities at which operations can be invoked by way of the Dispatcher.

public enum class DispatcherPriority
public enum DispatcherPriority
type DispatcherPriority = 
Public Enum DispatcherPriority
継承
DispatcherPriorityDispatcherPriorityDispatcherPriorityDispatcherPriority

フィールド

ApplicationIdle ApplicationIdle ApplicationIdle ApplicationIdle 2

列挙値は 2 です。The enumeration value is 2. アプリケーションがアイドル状態のときに操作が処理されます。Operations are processed when the application is idle.

Background Background Background Background 4

列挙値は 4 です。The enumeration value is 4. 他のすべての非アイドル状態の操作が完了した後に操作が処理されます。Operations are processed after all other non-idle operations are completed.

ContextIdle ContextIdle ContextIdle ContextIdle 3

列挙値は 3 です。The enumeration value is 3. バックグラウンド操作が完了した後に操作が処理されます。Operations are processed after background operations have completed.

DataBind DataBind DataBind DataBind 8

列挙値は 8 です。The enumeration value is 8. データ バインディングと同じ優先順位で操作が処理されます。Operations are processed at the same priority as data binding.

Inactive Inactive Inactive Inactive 0

列挙値は 0 です。The enumeration value is 0. 操作は処理されません。Operations are not processed.

Input Input Input Input 5

列挙値は 5 です。The enumeration value is 5. 入力と同じ優先順位で操作が処理されます。Operations are processed at the same priority as input.

Invalid Invalid Invalid Invalid -1

列挙値は -1 です。The enumeration value is -1. これは無効な優先順位です。This is an invalid priority.

Loaded Loaded Loaded Loaded 6

列挙値は 6 です。The enumeration value is 6. レイアウトとレンダリングが完了した後、入力の優先順位の付いた項目が処理される直前に、操作が処理されます。Operations are processed when layout and render has finished but just before items at input priority are serviced. 具体的には、これは、Loaded イベントを発生させるときに使用されます。Specifically this is used when raising the Loaded event.

Normal Normal Normal Normal 9

列挙値は 9 です。The enumeration value is 9. 通常の優先順位で操作が処理されます。Operations are processed at normal priority. これが一般的なアプリケーションの優先順位です。This is the typical application priority.

Render Render Render Render 7

列挙値は 7 です。The enumeration value is 7. レンダリングと同じ優先順位で操作が処理されます。Operations processed at the same priority as rendering.

Send Send Send Send 10

列挙値は 10 です。The enumeration value is 10. 他の非同期操作の前に操作が処理されます。Operations are processed before other asynchronous operations. これが最も高い優先順位です。This is the highest priority.

SystemIdle SystemIdle SystemIdle SystemIdle 1

列挙値は 1 です。The enumeration value is 1. システムがアイドル状態のときに操作が処理されます。Operations are processed when the system is idle.

次の例は、引数をBeginInvoke受け入れるデリゲートを渡すの呼び出しです。The following example is a call to BeginInvoke that passes a delegate which accepts an argument. 優先順位は Normal に設定されています。The priority is set to Normal.

// 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)

注釈

現在のWPFWPFバージョンのでは、Applicationidle と ContextIdle に対応する特定のシステム状態または "アイドル" はありません。There is no specific system state or "idleness" corresponding to ApplicationIdle and ContextIdle in the current version of WPFWPF. どちらも有効な優先順位です。したがって、優先度が ContextIdle の操作は、システムの優先度が SystemIdle である操作よりも優先度が高くなります。Both are still valid priorities; therefore, an operation with a priority of ContextIdle has a higher priority than an operation with a priority of SystemIdle.

ApplicationIdle 、CPU の特定の割合を超えた場合に、操作の実行を調整しません。The ApplicationIdle does not throttle the execution of an operation if it exceeds a certain percentage of the CPU. タイマーを使用するプロセスを調整する方法の1つです。One way to throttle a process it to use a timer.

操作が Send の優先順位Invokeで独自ContextIdleのによって送信された場合、操作はキューをバイパスし、直ちに実行されます。If an operation is posted using Invoke on its own ContextIdle at a priority of Send, the operation bypasses the queue and is immediately executed.

適用対象