SqlDataReader.ReadAsync(CancellationToken) 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

非同步版本的 Read()，這個版本會將 SqlDataReader 前移至下一筆記錄。

取消語彙基元可用於要求在命令逾時之前捨棄作業。例外狀況將經由傳回的 Task 物件回報。

public:
 override System::Threading::Tasks::Task<bool> ^ ReadAsync(System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task<bool> ReadAsync (System.Threading.CancellationToken cancellationToken);

override this.ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overrides Function ReadAsync (cancellationToken As CancellationToken) As Task(Of Boolean)

取消指令。

表示非同步作業的工作。

在工作完成前，對同一個執行個體呼叫 ReadAsync(CancellationToken) 不止一次。

SqlException

SQL Server 於執行命令文字時傳回錯誤。

如果的 behaviorExecuteReaderAsync 參數設定 Default為， ReadAsync 則會在傳回Task之前讀取整個數據列。

如需有關 .NET Framework Data Provider for SQL Server 中異步程式設計的詳細資訊，請參閱異步程序設計。

注意

讀取大型數據 (二進位/文字) 時，建議使用 Read 以獲得最佳效能。