Task.WaitAsync 方法

定義

命名空間:

System.Threading.Tasks

組件:

netstandard.dll, System.Runtime.dll

多載

名稱	Description
WaitAsync(CancellationToken)	會收到 Task 一個「當這 Task 件事完成或 CancellationToken 指定取消時才會完成」的訊息。
WaitAsync(TimeSpan)	得到 Task 一個 會在該時間 Task 結束或指定的超時結束時完成。
WaitAsync(TimeSpan, CancellationToken)	會得到 Task 一個 會在完成時 Task 完成、指定的逾時結束，或指定的 CancellationToken 取消請求時完成。
WaitAsync(TimeSpan, TimeProvider)	得到 Task 一個 會在該時間 Task 結束或指定的超時結束時完成。
WaitAsync(TimeSpan, TimeProvider, CancellationToken)	會得到 Task 一個 會在完成時 Task 完成、指定的逾時結束，或指定的 CancellationToken 取消請求時完成。

WaitAsync(CancellationToken)

來源:

Task.cs

會收到 Task 一個「當這 Task 件事完成或 CancellationToken 指定取消時才會完成」的訊息。

public:
 System::Threading::Tasks::Task ^ WaitAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task WaitAsync(System.Threading.CancellationToken cancellationToken);

member this.WaitAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function WaitAsync (cancellationToken As CancellationToken) As Task

參數

cancellationToken

CancellationToken

他們 CancellationToken 需要監控取消申請。

傳回

Task

代表 Task 非同步等待。 它可能和目前的實例是同一個實例，也可能不是。

例外狀況

OperationCanceledException

取消令牌也被取消了。 此例外會儲存在回傳的任務中。

備註

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 Wait()拋出的例外。

WaitAsync(TimeSpan)

來源:

Task.cs

得到 Task 一個 會在該時間 Task 結束或指定的超時結束時完成。

public:
 System::Threading::Tasks::Task ^ WaitAsync(TimeSpan timeout);

public System.Threading.Tasks.Task WaitAsync(TimeSpan timeout);

member this.WaitAsync : TimeSpan -> System.Threading.Tasks.Task

Public Function WaitAsync (timeout As TimeSpan) As Task

參數

timeout

TimeSpan

逾時 Task 後，如果還沒完成，應該會被錯誤處理 TimeoutException 。

傳回

Task

代表 Task 非同步等待。 它可能和目前的實例是同一個實例，也可能不是。

備註

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 Wait(TimeSpan)拋出的例外。

WaitAsync(TimeSpan, CancellationToken)

來源:

Task.cs

會得到 Task 一個 會在完成時 Task 完成、指定的逾時結束，或指定的 CancellationToken 取消請求時完成。

public:
 System::Threading::Tasks::Task ^ WaitAsync(TimeSpan timeout, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task WaitAsync(TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

member this.WaitAsync : TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function WaitAsync (timeout As TimeSpan, cancellationToken As CancellationToken) As Task

參數

timeout

TimeSpan

逾時 Task 後，如果還沒完成，應該會被錯誤處理 TimeoutException 。

cancellationToken

CancellationToken

他們 CancellationToken 需要監控取消申請。

傳回

Task

代表 Task 非同步等待。 它可能和目前的實例是同一個實例，也可能不是。

例外狀況

OperationCanceledException

取消令牌也被取消了。 此例外會儲存在回傳的任務中。

備註

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 Wait(TimeSpan)拋出的例外。

WaitAsync(TimeSpan, TimeProvider)

來源:

Task.cs

得到 Task 一個 會在該時間 Task 結束或指定的超時結束時完成。

public:
 System::Threading::Tasks::Task ^ WaitAsync(TimeSpan timeout, TimeProvider ^ timeProvider);

public System.Threading.Tasks.Task WaitAsync(TimeSpan timeout, TimeProvider timeProvider);

member this.WaitAsync : TimeSpan * TimeProvider -> System.Threading.Tasks.Task

Public Function WaitAsync (timeout As TimeSpan, timeProvider As TimeProvider) As Task

參數

timeout

TimeSpan

逾時 Task 後，如果還沒完成，應該會被錯誤處理 TimeoutException 。

timeProvider

TimeProvider

用來 TimeProvider 解釋 timeout。

傳回

Task

代表 Task 非同步等待。 它可能和目前的實例是同一個實例，也可能不是。

例外狀況

ArgumentNullException

論 timeProvider 點為 null。

WaitAsync(TimeSpan, TimeProvider, CancellationToken)

來源:

Task.cs

會得到 Task 一個 會在完成時 Task 完成、指定的逾時結束，或指定的 CancellationToken 取消請求時完成。

public:
 System::Threading::Tasks::Task ^ WaitAsync(TimeSpan timeout, TimeProvider ^ timeProvider, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task WaitAsync(TimeSpan timeout, TimeProvider timeProvider, System.Threading.CancellationToken cancellationToken);

member this.WaitAsync : TimeSpan * TimeProvider * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function WaitAsync (timeout As TimeSpan, timeProvider As TimeProvider, cancellationToken As CancellationToken) As Task

參數

timeout

TimeSpan

逾時 Task 後，如果還沒完成，應該會被錯誤處理 TimeoutException 。

timeProvider

TimeProvider

用來 TimeProvider 解釋 timeout。

cancellationToken

CancellationToken

他們 CancellationToken 需要監控取消申請。

傳回

Task

代表 Task 非同步等待。 它可能和目前的實例是同一個實例，也可能不是。

例外狀況

ArgumentNullException

論 timeProvider 點為 null。

TimeoutException

暫停時間到了。 此例外會儲存在回傳的任務中。

OperationCanceledException

取消令牌也被取消了。 此例外會儲存在回傳的任務中。