SqlDataReader.IsDBNullAsync(Int32, CancellationToken) 方法

定義

重要

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

IsDBNull(Int32) 的非同步版本，該版本會取得值，表示資料行是否包含不存在或遺漏的值。

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

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)

要擷取的以零起始的資料行。

取消指令，其會傳播說明應該取消作業的通知。這並不保證取消。如果設定為 CancellationToken.None，就會使這個方法相當於 IsDBNull(Int32)。傳回的工作必須標記為已取消。

如果指定的資料行值等於 true，則為 DBNull，否則為 false。

在資料擷取期間，連線中斷或關閉。

SqlDataReader在資料擷取期間已關閉。

沒有可供讀取的資料 (例如，第一個 Read() 沒有被呼叫，或傳回 false)。

嘗試在循序模式下讀取先前讀取的資料行。

有進行中的非同步作業。當在循序模式中執行時，此適用於所有 Get* 方法，因為在讀取資料流時可能會呼叫它們。

在連接字串中指定了 Context Connection=true。

嘗試讀取不存在的資料行。

解除標記已取消。此例外狀況會儲存在傳回的工作中。

如需詳細資訊，請參閱 SqlClient 串流支援。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。使用例外狀況，例如 ArgumentException 仍會同步擲回。如需預存例外狀況，請參閱擲回的 IsDBNull(Int32) 例外狀況。