TaskCanceledException 建構函式

定義

命名空間:

System.Threading.Tasks

組件:

netstandard.dll, System.Runtime.dll

初始化 TaskCanceledException 類別的新執行個體。

多載

名稱	Description
TaskCanceledException()	初始化該類別的新實例 TaskCanceledException ，並以系統提供的訊息描述錯誤。
TaskCanceledException(String)	初始化類別的新實例 TaskCanceledException ，並以指定訊息描述錯誤。
TaskCanceledException(Task)	初始化一個新的類別實例 TaskCanceledException ，並引用 Task 已被取消的 。
TaskCanceledException(SerializationInfo, StreamingContext)	已淘汰. 初始化一個新的類別實例 TaskCanceledException ，並使用序列化資料。
TaskCanceledException(String, Exception)	初始化類別的新實例 TaskCanceledException ，並附上指定的錯誤訊息及導致該異常的內部例外的參考。
TaskCanceledException(String, Exception, CancellationToken)	初始化類別的新實例 TaskCanceledException ，並附上指定錯誤訊息、指向導致該例外的內部例外，以及 CancellationToken 觸發取消的例外。

TaskCanceledException()

來源:

TaskCanceledException.cs

初始化該類別的新實例 TaskCanceledException ，並以系統提供的訊息描述錯誤。

public:
 TaskCanceledException();

public TaskCanceledException();

Public Sub New ()

備註

此建構器將新實例的屬性初始 Message 化為系統提供的訊息，描述錯誤。 此訊息考量了當前系統文化。

下表顯示了 的 OperationCanceledException初始屬性值：

房產	價值
InnerException	null。
Message	區域化錯誤訊息字串。

另請參閱

• 處理與拋出例外
• 以任務導向的異步程式設計
• 工作取消
• 如何：取消任務及其子任務

TaskCanceledException(String)

來源:

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初始屬性值。

房產	價值
InnerException	null。
Message	錯誤訊息字串在 message中指定。

另請參閱

• 處理與拋出例外
• 以任務導向的異步程式設計
• 工作取消
• 如何：取消任務及其子任務

TaskCanceledException(Task)

來源:

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)

來源:

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)

來源:

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 屬性回傳與傳入建構子相同的值，或 null 若該 InnerException 性質未提供內部例外值給建構子。

下表顯示了 的 TaskCanceledException初始屬性值。

房產	價值
InnerException	null。
Message	錯誤訊息字串在 message中指定。

另請參閱

• 處理與拋出例外
• 以任務導向的異步程式設計
• 工作取消
• 如何：取消任務及其子任務

TaskCanceledException(String, Exception, CancellationToken)

來源:

TaskCanceledException.cs

初始化類別的新實例 TaskCanceledException ，並附上指定錯誤訊息、指向導致該例外的內部例外，以及 CancellationToken 觸發取消的例外。

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

觸發取消的代幣。