Dispatcher.InvokeAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет указанный делегат асинхронно в потоке Dispatcher , с которым связан.
Перегрузки
| Имя | Описание |
|---|---|
| InvokeAsync(Action) |
Выполняет указанный Action асинхронно в потоке Dispatcher , с которым связан. |
| InvokeAsync(Action, DispatcherPriority) |
Выполняет указанный Action асинхронно по указанному приоритету в потоке Dispatcher , с которым связан. |
| InvokeAsync(Action, DispatcherPriority, CancellationToken) |
Выполняет указанный Action асинхронно по указанному приоритету в потоке Dispatcher , с которым связан. |
| InvokeAsync<TResult>(Func<TResult>, DispatcherPriority, CancellationToken) |
Выполняет указанный Func<TResult> асинхронно по указанному приоритету в потоке Dispatcher , с которым связан. |
| InvokeAsync<TResult>(Func<TResult>) |
Выполняет указанный Func<TResult> асинхронно в потоке Dispatcher , с которым связан. |
| InvokeAsync<TResult>(Func<TResult>, DispatcherPriority) |
Выполняет указанный Func<TResult> асинхронно по указанному приоритету в потоке Dispatcher , с которым связан. |
InvokeAsync(Action)
Выполняет указанный Action асинхронно в потоке Dispatcher , с которым связан.
public:
System::Windows::Threading::DispatcherOperation ^ InvokeAsync(Action ^ callback);
public System.Windows.Threading.DispatcherOperation InvokeAsync(Action callback);
member this.InvokeAsync : Action -> System.Windows.Threading.DispatcherOperation
Public Function InvokeAsync (callback As Action) As DispatcherOperation
Параметры
- callback
- Action
Делегат для вызова через диспетчер.
Возвращаемое значение
Объект, который возвращается сразу после InvokeAsync(Action) вызова, который можно использовать для взаимодействия с делегатом, так как он ожидает выполнения в очереди событий.
Комментарии
Приоритет по умолчанию — DispatcherPriority.Normal.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Invoke(Action).
Применяется к
InvokeAsync(Action, DispatcherPriority)
Выполняет указанный Action асинхронно по указанному приоритету в потоке Dispatcher , с которым связан.
public:
System::Windows::Threading::DispatcherOperation ^ InvokeAsync(Action ^ callback, System::Windows::Threading::DispatcherPriority priority);
public System.Windows.Threading.DispatcherOperation InvokeAsync(Action callback, System.Windows.Threading.DispatcherPriority priority);
member this.InvokeAsync : Action * System.Windows.Threading.DispatcherPriority -> System.Windows.Threading.DispatcherOperation
Public Function InvokeAsync (callback As Action, priority As DispatcherPriority) As DispatcherOperation
Параметры
- callback
- Action
Делегат для вызова через диспетчер.
- priority
- DispatcherPriority
Приоритет, определяющий порядок вызова указанного обратного вызова относительно других ожидающих операций в объекте Dispatcher.
Возвращаемое значение
Объект, который возвращается сразу после InvokeAsync(Action, DispatcherPriority) вызова, который можно использовать для взаимодействия с делегатом, так как он ожидает выполнения в очереди событий.
Комментарии
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Invoke(Action, DispatcherPriority).
Применяется к
InvokeAsync(Action, DispatcherPriority, CancellationToken)
Выполняет указанный Action асинхронно по указанному приоритету в потоке Dispatcher , с которым связан.
public:
System::Windows::Threading::DispatcherOperation ^ InvokeAsync(Action ^ callback, System::Windows::Threading::DispatcherPriority priority, System::Threading::CancellationToken cancellationToken);
public System.Windows.Threading.DispatcherOperation InvokeAsync(Action callback, System.Windows.Threading.DispatcherPriority priority, System.Threading.CancellationToken cancellationToken);
member this.InvokeAsync : Action * System.Windows.Threading.DispatcherPriority * System.Threading.CancellationToken -> System.Windows.Threading.DispatcherOperation
Public Function InvokeAsync (callback As Action, priority As DispatcherPriority, cancellationToken As CancellationToken) As DispatcherOperation
Параметры
- callback
- Action
Делегат для вызова через диспетчер.
- priority
- DispatcherPriority
Приоритет, определяющий порядок вызова указанного обратного вызова относительно других ожидающих операций в объекте Dispatcher.
- cancellationToken
- CancellationToken
Объект, указывающий, следует ли отменить действие.
Возвращаемое значение
Объект, который возвращается сразу после InvokeAsync(Action, DispatcherPriority, CancellationToken) вызова, который можно использовать для взаимодействия с делегатом, так как он ожидает выполнения в очереди событий.
Исключения
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
Комментарии
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Invoke(Action, DispatcherPriority).
Применяется к
InvokeAsync<TResult>(Func<TResult>, DispatcherPriority, CancellationToken)
Выполняет указанный Func<TResult> асинхронно по указанному приоритету в потоке Dispatcher , с которым связан.
public:
generic <typename TResult>
System::Windows::Threading::DispatcherOperation<TResult> ^ InvokeAsync(Func<TResult> ^ callback, System::Windows::Threading::DispatcherPriority priority, System::Threading::CancellationToken cancellationToken);
public System.Windows.Threading.DispatcherOperation<TResult> InvokeAsync<TResult>(Func<TResult> callback, System.Windows.Threading.DispatcherPriority priority, System.Threading.CancellationToken cancellationToken);
member this.InvokeAsync : Func<'Result> * System.Windows.Threading.DispatcherPriority * System.Threading.CancellationToken -> System.Windows.Threading.DispatcherOperation<'Result>
Public Function InvokeAsync(Of TResult) (callback As Func(Of TResult), priority As DispatcherPriority, cancellationToken As CancellationToken) As DispatcherOperation(Of TResult)
Параметры типа
- TResult
Возвращаемый тип значения указанного делегата.
Параметры
- callback
- Func<TResult>
Делегат для вызова через диспетчер.
- priority
- DispatcherPriority
Приоритет, определяющий порядок вызова указанного обратного вызова относительно других ожидающих операций в объекте Dispatcher.
- cancellationToken
- CancellationToken
Объект, указывающий, следует ли отменить операцию.
Возвращаемое значение
Объект, который возвращается сразу после InvokeAsync<TResult>(Func<TResult>, DispatcherPriority, CancellationToken) вызова, который можно использовать для взаимодействия с делегатом, так как он ожидает выполнения в очереди событий.
Исключения
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
Применяется к
InvokeAsync<TResult>(Func<TResult>)
Выполняет указанный Func<TResult> асинхронно в потоке Dispatcher , с которым связан.
public:
generic <typename TResult>
System::Windows::Threading::DispatcherOperation<TResult> ^ InvokeAsync(Func<TResult> ^ callback);
public System.Windows.Threading.DispatcherOperation<TResult> InvokeAsync<TResult>(Func<TResult> callback);
member this.InvokeAsync : Func<'Result> -> System.Windows.Threading.DispatcherOperation<'Result>
Public Function InvokeAsync(Of TResult) (callback As Func(Of TResult)) As DispatcherOperation(Of TResult)
Параметры типа
- TResult
Возвращаемый тип значения указанного делегата.
Параметры
- callback
- Func<TResult>
Делегат для вызова через диспетчер.
Возвращаемое значение
Объект, который возвращается сразу после InvokeAsync<TResult>(Func<TResult>) вызова, который можно использовать для взаимодействия с делегатом, так как он ожидает выполнения в очереди событий.
Применяется к
InvokeAsync<TResult>(Func<TResult>, DispatcherPriority)
Выполняет указанный Func<TResult> асинхронно по указанному приоритету в потоке Dispatcher , с которым связан.
public:
generic <typename TResult>
System::Windows::Threading::DispatcherOperation<TResult> ^ InvokeAsync(Func<TResult> ^ callback, System::Windows::Threading::DispatcherPriority priority);
public System.Windows.Threading.DispatcherOperation<TResult> InvokeAsync<TResult>(Func<TResult> callback, System.Windows.Threading.DispatcherPriority priority);
member this.InvokeAsync : Func<'Result> * System.Windows.Threading.DispatcherPriority -> System.Windows.Threading.DispatcherOperation<'Result>
Public Function InvokeAsync(Of TResult) (callback As Func(Of TResult), priority As DispatcherPriority) As DispatcherOperation(Of TResult)
Параметры типа
- TResult
Возвращаемый тип значения указанного делегата.
Параметры
- callback
- Func<TResult>
Делегат для вызова через диспетчер.
- priority
- DispatcherPriority
Приоритет, определяющий порядок вызова указанного обратного вызова относительно других ожидающих операций в объекте Dispatcher.
Возвращаемое значение
Объект, который возвращается сразу после InvokeAsync<TResult>(Func<TResult>, DispatcherPriority) вызова, который можно использовать для взаимодействия с делегатом, так как он ожидает выполнения в очереди событий.