语言

JoinableTaskFactory 类

定义

一个工厂,用于启动异步任务,当任务需要应用程序的主线程和主线程本身可能会阻止任务完成时,可以缓解死锁。

public ref class JoinableTaskFactory
[Windows::Foundation::Metadata::WebHostHidden]
class JoinableTaskFactory
public class JoinableTaskFactory
type JoinableTaskFactory = class
Public Class JoinableTaskFactory
继承
JoinableTaskFactory
派生

注解

有关更完整的注释,请参阅 < a0 /&;。

构造函数

名称 说明
JoinableTaskFactory(JoinableTaskCollection)

初始化将所有生成的作业添加到指定集合的 JoinableTaskFactory 类的新实例。

JoinableTaskFactory(JoinableTaskContext)

初始化 JoinableTaskFactory 类的新实例。

属性

名称 说明
Context

获取此工厂所属的可联接任务上下文。

HangDetectionTimeout

获取或设置超时,之后,同步阻塞时没有任何活动表明发生了挂起。

UnderlyingSynchronizationContext

获取控制主机中主线程的基础 SynchronizationContext 。

方法

名称 说明
Add(JoinableTask)

将指定的可联接任务添加到适用的集合。

DisableProcessing()

防止筛选的消息泵在同步等待环境 JoinableTask期间运行。

IsWaitingOnLongRunningTask()

检查当前 joinableTask 是否正在等待长时间运行的任务。

OnTransitionedToMainThread(JoinableTask, Boolean)

每当可联接任务完成到主线程的转换时引发。

OnTransitioningToMainThread(JoinableTask)

当可加入的任务请求转换到主线程时引发。

PostToUnderlyingSynchronizationContext(SendOrPostCallback, Object)

在主线程可用时,将消息发布到指定的基础 SynchronizationContext 进行处理。

Run(Func<Task>, JoinableTaskCreationOptions)

运行指定的异步方法以完成,同时同步阻止调用线程。

Run(Func<Task>)

运行指定的异步方法以完成,同时同步阻止调用线程。

Run<T>(Func<Task<T>>, JoinableTaskCreationOptions)

运行指定的异步方法以完成,同时同步阻止调用线程。

Run<T>(Func<Task<T>>)

运行指定的异步方法以完成,同时同步阻止调用线程。

RunAsync(Func<Task>, JoinableTaskCreationOptions)

在调用方线程上调用异步委托,并在异步方法生成时返回给调用方。 异步委托在异步方法被阻止等待异步方法完成时,以缓解死锁的方式调用异步方法时需要主线程。

RunAsync(Func<Task>, String, JoinableTaskCreationOptions)

一个工厂,用于启动异步任务,当任务需要应用程序的主线程和主线程本身可能会阻止任务完成时,可以缓解死锁。

RunAsync(Func<Task>)

在调用方线程上调用异步委托,并在异步方法生成时返回给调用方。 异步委托在异步方法被阻止等待异步方法完成时,以缓解死锁的方式调用异步方法时需要主线程。

RunAsync<T>(Func<Task<T>>, JoinableTaskCreationOptions)

在调用方线程上调用异步委托,并在异步方法生成时返回给调用方。 异步委托在异步方法被阻止等待异步方法完成时,以缓解死锁的方式调用异步方法时需要主线程。

RunAsync<T>(Func<Task<T>>, String, JoinableTaskCreationOptions)

一个工厂,用于启动异步任务,当任务需要应用程序的主线程和主线程本身可能会阻止任务完成时,可以缓解死锁。

RunAsync<T>(Func<Task<T>>)

在调用方线程上调用异步委托,并在异步方法生成时返回给调用方。 异步委托在异步方法被阻止等待异步方法完成时,以缓解死锁的方式调用异步方法时需要主线程。

SwitchToMainThreadAsync(Boolean, CancellationToken)

获取一个可等待对象,其延续在初始化此实例的同步上下文上执行,从而缓解死锁和重新进入。

SwitchToMainThreadAsync(CancellationToken)

获取一个可等待对象,其延续在主线程上执行,从而缓解死锁和重新进入。

WaitSynchronously(Task)

同步阻止调用线程完成指定的任务。 如果在主线程上运行,则线程睡眠时会抑制任何适用的消息泵。

WaitSynchronouslyCore(Task)

同步阻止调用线程完成指定的任务。

扩展方法

名称 说明
Run(JoinableTaskFactory, String, Func<IProgress<ThreadedWaitDialogProgressData>,CancellationToken,Task>, Nullable<TimeSpan>)

阻止调用 (UI) 线程,直到可取消的异步操作完成。 如果操作花费的时间过长,则会显示可选的可取消等待对话框。

Run(JoinableTaskFactory, String, Func<IProgress<ThreadedWaitDialogProgressData>,Task>, Nullable<TimeSpan>)

阻止调用 (UI) 线程,直到异步操作完成。 如果操作花费的时间过长,则会显示可选的可取消等待对话框。

Run(JoinableTaskFactory, String, String, Func<IProgress<ThreadedWaitDialogProgressData>,CancellationToken,Task>, Nullable<TimeSpan>)

阻止调用 (UI) 线程,直到异步操作完成。 向用户提供取消。

Run(JoinableTaskFactory, String, String, Func<IProgress<ThreadedWaitDialogProgressData>,Task>, Nullable<TimeSpan>)

阻止调用 (UI) 线程,直到异步操作完成。 不会向用户提供取消。

Run<T>(JoinableTaskFactory, String, Func<IProgress<ThreadedWaitDialogProgressData>,CancellationToken,Task<T>>, Nullable<TimeSpan>)

阻止调用 (UI) 线程,直到可取消的异步操作完成。 如果操作花费的时间过长,则会显示可选的可取消等待对话框。

Run<T>(JoinableTaskFactory, String, Func<IProgress<ThreadedWaitDialogProgressData>,Task<T>>, Nullable<TimeSpan>)

阻止调用 (UI) 线程,直到异步操作完成。 如果操作花费的时间过长,则会显示可选的可取消等待对话框。

Run<T>(JoinableTaskFactory, String, String, Func<IProgress<ThreadedWaitDialogProgressData>,CancellationToken,Task<T>>, Nullable<TimeSpan>)

阻止调用 (UI) 线程,直到异步操作完成。 向用户提供取消。

Run<T>(JoinableTaskFactory, String, String, Func<IProgress<ThreadedWaitDialogProgressData>,Task<T>>, Nullable<TimeSpan>)

阻止调用 (UI) 线程,直到异步操作完成。 不会向用户提供取消。

RunAsync(JoinableTaskFactory, VsTaskRunContext, Func<Task>)

包装异步方法的调用,以便它可以异步执行,但将来可能同步完成(等待)。

RunAsync<T>(JoinableTaskFactory, VsTaskRunContext, Func<Task<T>>)

包装异步方法的调用,以便它可以异步执行,但将来可能同步完成(等待)。

RunAsyncAsVsTask<T>(JoinableTaskFactory, VsTaskRunContext, Func<CancellationToken,Task<T>>)

创建 IVsTask 以跟踪可取消的异步操作。

StartOnIdle(JoinableTaskFactory, Action, VsTaskRunContext)

在 UI 线程上计划后台执行的委托,而无需从其调用方继承对 UI 线程的任何声明。

StartOnIdle(JoinableTaskFactory, Func<Task>, VsTaskRunContext)

在 UI 线程上计划后台执行的委托,而无需从其调用方继承对 UI 线程的任何声明。

WithPriority(JoinableTaskFactory, Dispatcher, DispatcherPriority)

创建一个 JoinableTaskFactory 计划,该计划适用于指定的 Dispatcher 和 DispatcherPriority。

WithPriority(JoinableTaskFactory, VsTaskRunContext)

创建一个JoinableTaskFactory计划,该计划使用指定的Visual Studio UI 线程优先级。

适用于

线程安全性

此类型对所有成员都是线程安全的。