TaskCanceledException 构造函数

定义

命名空间:

System.Threading.Tasks

程序集:

System.Runtime.dll

初始化 TaskCanceledException 类的新实例。

重载

TaskCanceledException()	使用说明错误的系统提供的消息初始化 TaskCanceledException 类的新实例。
TaskCanceledException(String)	使用说明错误的指定消息初始化 TaskCanceledException 类的新实例。
TaskCanceledException(Task)	使用对已取消的 TaskCanceledException 的引用初始化 Task 类的新实例。
TaskCanceledException(SerializationInfo, StreamingContext)	已过时. 用序列化数据初始化 TaskCanceledException 类的新实例。
TaskCanceledException(String, Exception)	使用指定的错误消息和对作为此异常原因的内部异常的引用来初始化 TaskCanceledException 类的新实例。
TaskCanceledException(String, Exception, CancellationToken)	用指定的错误消息、对导致此异常的内部异常的引用以及触发取消的 CancellationToken 初始化 TaskCanceledException 类的新实例。

TaskCanceledException()

Source:

TaskCanceledException.cs

使用说明错误的系统提供的消息初始化 TaskCanceledException 类的新实例。

public:
 TaskCanceledException();

public TaskCanceledException ();

Public Sub New ()

注解

此构造函数将新实例的 Message 属性初始化为系统提供的错误描述消息。 此消息会考虑当前系统区域性。

下表显示了 实例 OperationCanceledException的初始属性值：

properties	值
InnerException	null.
Message	本地化的错误消息字符串。

另请参阅

• 处理和引发异常
• 基于任务的异步编程
• 任务取消
• 如何：取消任务及其子级

TaskCanceledException(String)

Source:

TaskCanceledException.cs

使用说明错误的指定消息初始化 TaskCanceledException 类的新实例。

public:
 TaskCanceledException(System::String ^ message);

public TaskCanceledException (string? message);

new System.Threading.Tasks.TaskCanceledException : string -> System.Threading.Tasks.TaskCanceledException

Public Sub New (message As String)

参数

message

String

描述该异常的消息。 此构造函数的调用方需要确保此字符串已针对当前系统区域性进行了本地化。

注解

下表显示了 TaskCanceledException 实例的初始属性值。

properties	值
InnerException	null.
Message	message 中指定的错误消息字符串。

另请参阅

• 处理和引发异常
• 基于任务的异步编程
• 任务取消
• 如何：取消任务及其子级

TaskCanceledException(Task)

Source:

TaskCanceledException.cs

使用对已取消的 TaskCanceledException 的引用初始化 Task 类的新实例。

public:
 TaskCanceledException(System::Threading::Tasks::Task ^ task);

public TaskCanceledException (System.Threading.Tasks.Task? task);

new System.Threading.Tasks.TaskCanceledException : System.Threading.Tasks.Task -> System.Threading.Tasks.TaskCanceledException

Public Sub New (task As Task)

参数

task

Task

已取消的任务。

另请参阅

• 处理和引发异常
• 基于任务的异步编程
• 任务取消
• 如何：取消任务及其子级

TaskCanceledException(SerializationInfo, StreamingContext)

Source:

TaskCanceledException.cs

注意

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

用序列化数据初始化 TaskCanceledException 类的新实例。

protected:
 TaskCanceledException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected TaskCanceledException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Threading.Tasks.TaskCanceledException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Threading.Tasks.TaskCanceledException

Protected Sub New (info As SerializationInfo, context As StreamingContext)

参数

info

SerializationInfo

承载序列化对象数据的对象。

context

StreamingContext

关于来源和目标的上下文信息

属性

ObsoleteAttribute

注解

在反序列化期间调用此构造函数以重新构造在流上传输的异常对象。 有关详细信息，请参阅 XML 和 SOAP 序列化。

另请参阅

• 处理和引发异常
• 基于任务的异步编程
• 任务取消
• 如何：取消任务及其子级
• XML 和 SOAP 序列化

TaskCanceledException(String, Exception)

Source:

TaskCanceledException.cs

使用指定的错误消息和对作为此异常原因的内部异常的引用来初始化 TaskCanceledException 类的新实例。

public:
 TaskCanceledException(System::String ^ message, Exception ^ innerException);

public TaskCanceledException (string? message, Exception? innerException);

new System.Threading.Tasks.TaskCanceledException : string * Exception -> System.Threading.Tasks.TaskCanceledException

Public Sub New (message As String, innerException As Exception)

参数

message

String

描述该异常的消息。 此构造函数的调用方需要确保此字符串已针对当前系统区域性进行了本地化。

innerException

Exception

导致当前异常的异常。 如果 innerException 参数不为 null，则当前异常将在处理内部异常的 catch 块中引发。

注解

因前一个异常而直接引发的异常应在 InnerException 属性中包含对前一个异常的引用。 InnerException 属性将返回传递给构造函数的同一值；如果 InnerException 属性不向构造函数提供内部异常值，则返回 null。

下表显示了 TaskCanceledException 实例的初始属性值。

properties	值
InnerException	null.
Message	message 中指定的错误消息字符串。

另请参阅

• 处理和引发异常
• 基于任务的异步编程
• 任务取消
• 如何：取消任务及其子级

TaskCanceledException(String, Exception, CancellationToken)

Source:

TaskCanceledException.cs

用指定的错误消息、对导致此异常的内部异常的引用以及触发取消的 CancellationToken 初始化 TaskCanceledException 类的新实例。

public:
 TaskCanceledException(System::String ^ message, Exception ^ innerException, System::Threading::CancellationToken token);

public TaskCanceledException (string? message, Exception? innerException, System.Threading.CancellationToken token);

new System.Threading.Tasks.TaskCanceledException : string * Exception * System.Threading.CancellationToken -> System.Threading.Tasks.TaskCanceledException

Public Sub New (message As String, innerException As Exception, token As CancellationToken)

参数

message

String

解释异常原因的错误消息。

innerException

Exception

导致当前异常的异常。

token

CancellationToken

触发取消的取消标记。