Dispatcher.InvokeAsync Метод

Определение

Пространство имен:

System.Windows.Threading

Сборка:

WindowsBase.dll

Выполняет заданный делегат асинхронно в потоке, с которым связан 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

Делегат, вызываемый с помощью диспетчера.

Возвращаемое значение

DispatcherOperation

Объект, возвращаемый сразу после вызова 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в .

Возвращаемое значение

DispatcherOperation

Объект, возвращаемый сразу после вызова 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

Объект, указывающий, следует ли отменить действие.

Возвращаемое значение

DispatcherOperation

Объект, возвращаемый сразу после вызова InvokeAsync(Action, DispatcherPriority, CancellationToken), используемый для взаимодействия с делегатом, ожидающим выполнения в очереди событий.

Исключения

OperationCanceledException

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

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

Объект, указывающий, следует ли отменить операцию.

Возвращаемое значение

DispatcherOperation<TResult>

Объект, возвращаемый сразу после вызова InvokeAsync<TResult>(Func<TResult>, DispatcherPriority, CancellationToken), используемый для взаимодействия с делегатом, ожидающим выполнения в очереди событий.

Исключения

OperationCanceledException

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

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>

Делегат, вызываемый с помощью диспетчера.

Возвращаемое значение

DispatcherOperation<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в .

Возвращаемое значение

DispatcherOperation<TResult>

Объект, возвращаемый сразу после вызова InvokeAsync<TResult>(Func<TResult>, DispatcherPriority), используемый для взаимодействия с делегатом, ожидающим выполнения в очереди событий.