Dispatcher.Yield Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Creates an awaitable object that asynchronously yields control back to the current dispatcher and provides an opportunity for the dispatcher to process other events.
Overloads
| Yield() |
Creates an awaitable object that asynchronously yields control back to the current dispatcher and provides an opportunity for the dispatcher to process other events. |
| Yield(DispatcherPriority) |
Creates an awaitable object that asynchronously yields control back to the current dispatcher and provides an opportunity for the dispatcher to process other events. The work that occurs when control returns to the code awaiting the result of this method is scheduled with the specified priority. |
Yield()
Creates an awaitable object that asynchronously yields control back to the current dispatcher and provides an opportunity for the dispatcher to process other events.
public:
static System::Windows::Threading::DispatcherPriorityAwaitable Yield();public static System.Windows.Threading.DispatcherPriorityAwaitable Yield ();static member Yield : unit -> System.Windows.Threading.DispatcherPriorityAwaitablePublic Shared Function Yield () As DispatcherPriorityAwaitableReturns
An awaitable object that asynchronously yields control back to the current dispatcher and provides an opportunity for the dispatcher to process other events.
Remarks
This method provides a way for you to temporarily release execution control to the current dispatcher so it can do other work, such as process other events. Use the await, or Await in Visual Basic, operator on the return value to return control to the current dispatcher. Use this method if want to give your app a chance to process events while you app is doing a lot of work on the UI thread. For example, you can use this method in a long-running loop that updates a control.
This method is equivalent to calling the Yield(DispatcherPriority) method and passing in DispatcherPriority.Background.
Applies to
Yield(DispatcherPriority)
Creates an awaitable object that asynchronously yields control back to the current dispatcher and provides an opportunity for the dispatcher to process other events. The work that occurs when control returns to the code awaiting the result of this method is scheduled with the specified priority.
public:
static System::Windows::Threading::DispatcherPriorityAwaitable Yield(System::Windows::Threading::DispatcherPriority priority);public static System.Windows.Threading.DispatcherPriorityAwaitable Yield (System.Windows.Threading.DispatcherPriority priority);static member Yield : System.Windows.Threading.DispatcherPriority -> System.Windows.Threading.DispatcherPriorityAwaitablePublic Shared Function Yield (priority As DispatcherPriority) As DispatcherPriorityAwaitableParameters
- priority
- DispatcherPriority
The priority at which to schedule the continuation.
Returns
An awaitable object that asynchronously yields control back to the current dispatcher and provides an opportunity for the dispatcher to process other events.
Remarks
This method provides a way for you to temporarily release execution control to the current dispatcher so it can do other work, such as process other events. Use the await, or Await in Visual Basic, operator on the return value to return control to the current dispatcher. Use this method if want to give your app a chance to process events while you app is doing a lot of work on the UI thread. For example, you can use this method in a long-running loop that updates a control.
