SqlCommand.ExecuteScalarAsync(CancellationToken) Yöntem

Tanım

ExecuteScalar()Sorgusunu zaman uyumsuz olarak yürüten ve sorgu tarafından döndürülen sonuç kümesindeki ilk satırın ilk sütununu döndüren zaman uyumsuz bir sürümü.An asynchronous version of ExecuteScalar(), which executes the query asynchronously and returns the first column of the first row in the result set returned by the query. Ek sütunlar veya satırlar yok sayılır.Additional columns or rows are ignored.

İptali belirteci, işlem komut zaman aşımı dolmadan işlemin iptal edilmesini istemek için kullanılabilir.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Özel durumlar döndürülen Görev nesnesi ile bildirilir.Exceptions will be reported via the returned Task object.

public:
 override System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync(System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task<object> ExecuteScalarAsync (System.Threading.CancellationToken cancellationToken);
override this.ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>
Public Overrides Function ExecuteScalarAsync (cancellationToken As CancellationToken) As Task(Of Object)

Parametreler

cancellationToken
CancellationToken

İptal yönergesi.The cancellation instruction.

Döndürülenler

Task<Object>

Zaman uyumsuz işlemi temsil eden bir görev.A task representing the asynchronous operation.

Özel durumlar

SqlDbTypeOlarak ayarlandığında binary veya varbinary 'Den başka bir değişken kullanıldı Value Stream .A SqlDbType other than Binary or VarBinary was used when Value was set to Stream. Akış hakkında daha fazla bilgi için bkz. SqlClient akış desteği.For more information about streaming, see SqlClient Streaming Support.

-veya--or-

SqlDbTypeOlarak ayarlandığında char, nchar, nvarchar, varcharveya XML dışında bir karakterkullanıldı Value TextReader .A SqlDbType other than Char, NChar, NVarChar, VarChar, or Xml was used when Value was set to TextReader.

-veya--or-

SqlDbTypeOlarak ayarlandığında, XML dışında bir diğeri kullanılmıştır Value XmlReader .A SqlDbType other than Xml was used when Value was set to XmlReader.

ExecuteScalarAsync(CancellationToken)Görev tamamlanmadan önce aynı örnek için birden fazla kez çağrılıyor.Calling ExecuteScalarAsync(CancellationToken) more than once for the same instance before task completion.

-veya--or-

SqlConnectionBir akış işlemi sırasında kapatılan veya bırakılmış.The SqlConnection closed or dropped during a streaming operation. Akış hakkında daha fazla bilgi için bkz. SqlClient akış desteği.For more information about streaming, see SqlClient Streaming Support.

-veya--or-

Context Connection=true bağlantı dizesinde belirtilir.Context Connection=true is specified in the connection string.

SQL Server komut metnini yürütürken bir hata döndürdü.SQL Server returned an error while executing the command text.

-veya--or-

Akış işlemi sırasında zaman aşımı oluştu.A timeout occurred during a streaming operation. Akış hakkında daha fazla bilgi için bkz. SqlClient akış desteği.For more information about streaming, see SqlClient Streaming Support.

Stream XmlReader TextReader Akış işlemi sırasında veya nesnesinde bir hata oluştu.An error occurred in a Stream, XmlReader or TextReader object during a streaming operation. Akış hakkında daha fazla bilgi için bkz. SqlClient akış desteği.For more information about streaming, see SqlClient Streaming Support.

Stream, XmlReader Veya TextReader nesnesi bir akış işlemi sırasında kapatıldı.The Stream, XmlReader or TextReader object was closed during a streaming operation. Akış hakkında daha fazla bilgi için bkz. SqlClient akış desteği.For more information about streaming, see SqlClient Streaming Support.

Açıklamalar

SQL Server için .NET Framework Veri Sağlayıcısı zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. zaman uyumsuz programlama.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

Şunlara uygulanır

Ayrıca bkz.