SqlBatch.ExecuteScalarAsync(CancellationToken) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
的 ExecuteScalar()異步版本，它會執行批次，並傳回第一個傳回結果集中第一個數據列的第一個數據行。 所有其他數據行、數據列和結果集都會被忽略。
public override System.Threading.Tasks.Task<object> ExecuteScalarAsync (System.Threading.CancellationToken cancellationToken = default);override this.ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>Public Overrides Function ExecuteScalarAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of Object)參數
- cancellationToken
- CancellationToken
取消非同步作業的語彙基元。
傳回
第一個結果集中第一個數據列的第一個數據行。
例外狀況
執行批次時發生錯誤。
取消標記已取消。 此例外狀況會儲存在傳回的工作中。
備註
這個方法受益於 ExecuteScalarAsync(CancellationToken)，而且該方法的所有預期例外狀況也適用於這裡。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用例外狀況，例如 ArgumentException仍會同步擲回。