SqlDataReader.IsDBNullAsync(Int32, CancellationToken) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
非同步版本的 IsDBNull(Int32),該欄位獲得一個值,指示欄位是否包含不存在或缺失值。
取消標記可用來請求在指令逾時前放棄操作。 例外將透過回傳的任務物件回報。
public:
override System::Threading::Tasks::Task<bool> ^ IsDBNullAsync(int i, System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task<bool> IsDBNullAsync(int i, System.Threading.CancellationToken cancellationToken);
override this.IsDBNullAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
Public Overrides Function IsDBNullAsync (i As Integer, cancellationToken As CancellationToken) As Task(Of Boolean)
參數
- i
- Int32
要取的以零為基礎的欄位。
- cancellationToken
- CancellationToken
取消指令,會傳播通知,告知操作應該被取消。 這並不保證會被取消。 一個設定使 CancellationToken.None 此方法等價於 IsDBNull(Int32)。 退回的任務必須標記為已取消。
傳回
true 若指定的欄位值等價 DBNull 於 ,則 false。
例外狀況
在資料擷取過程中,連線會中斷或關閉。
在資料檢索時會關閉。SqlDataReader
沒有資料可供讀取(例如,第一個 Read() 資料尚未被呼叫或回傳為假)。
嘗試以順序模式閱讀之前已讀過的專欄。
當時正在進行一項非同步操作。 這適用於所有在序列模式下執行的 Get* 方法,因為在讀取串流時可以呼叫這些方法。
Context Connection=true 在連接字串中指定。
試著閱讀一篇不存在的專欄。
取消令牌也被取消了。 此例外會儲存在回傳的任務中。
備註
欲了解更多資訊,請參閱 SqlClient 串流支援。
此方法在任務中儲存所有非使用例外,該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外,該例外會在等待任務時拋出。 使用例外錯誤,例如 ArgumentException,仍會同步拋出。 關於儲存的例外,請參見由 IsDBNull(Int32)拋出的例外。