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.DispatcherOperationPublic 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.DispatcherOperationPublic 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.DispatcherOperationPublic 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), используемый для взаимодействия с делегатом, ожидающим выполнения в очереди событий.
