SqlDataReader.ReadAsync(CancellationToken) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
一個非同步版本的 Read()，將 推進 SqlDataReader 到下一個記錄。
取消標記可用來請求在指令逾時前放棄操作。 例外將透過回傳的任務物件回報。
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)參數
- cancellationToken
- CancellationToken
取消指示。
傳回
一個代表非同步操作的任務。
例外狀況
在同一 ReadAsync(CancellationToken) 個實例呼叫超過一次，任務才完成。
Context Connection=true 在連接字串中指定。
SQL Server 執行命令文字時回傳錯誤。
取消令牌也被取消了。 此例外會儲存在回傳的任務中。
備註
若behaviorExecuteReaderAsync參數 為 Default，ReadAsync則會讀取整列資料後返回任務。
欲了解更多關於.NET框架SQL Server Data Provider非同步程式設計的資訊，包括程式碼範例，請參見 非同步程式設計。
此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 Read()拋出的例外。