Task.WaitAsync 方法

定義

命名空間:

System.Threading.Tasks

組件:

System.Runtime.dll

多載

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。

OperationCanceledException

取消令牌已取消。 此例外狀況會儲存在傳回的工作中。