SqlCommand.ExecuteScalarAsync(CancellationToken) Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
sorguyu 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 sürümü ExecuteScalar(). Ek sütunlar veya satırlar yoksayılır.
İptal belirteci, komut zaman aşımı tamamlanmadan önce işlemin terk edilmesi isteğinde bulunmak için kullanılabilir. Özel durumlar döndürülen Görev nesnesi aracılığıyla bildirilir.
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 talimatı.
Döndürülenler
Zaman uyumsuz işlemi temsil eden bir görev.
Özel durumlar
SqlDbType olarak ayarlandığında İkili veya Value dışında bir değer kullanıldıStream. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.
-veya-
SqlDbType Olarak ayarlandığında Char, NChar, NVarChar, VarChar veya Value dışında bir değer kullanıldıTextReader.
-veya-
SqlDbType olarak ayarlandığında Value dışında bir değer kullanıldıXmlReader.
Görev tamamlanmadan önce aynı örnek için birden çok kez çağrılması ExecuteScalarAsync(CancellationToken) .
-veya-
Akış SqlConnection işlemi sırasında kapatılan veya bırakılan. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.
-veya-
Context Connection=true bağlantı dizesi belirtilir.
SQL Server komut metni yürütülürken bir hata döndürdü.
-veya-
Akış işlemi sırasında zaman aşımı oluştu. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.
Akış işlemi sırasında bir Streamveya XmlReaderTextReader nesnesinde hata oluştu. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.
bir Streamakış işlemi sırasında , XmlReader veya TextReader nesnesi kapatıldı. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.
İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.
Açıklamalar
SQL Server için .NET Framework Veri Sağlayıcısı zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Asynchronous Programming.
Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından ExecuteScalar()oluşan özel durumlara bakın.