DbCommand.ExecuteScalarAsync Yöntem

Tanım

Ad Alanı:

System.Data.Common

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Data.Common.dll

zaman uyumsuz sürümünü ExecuteScalar()uygular, ancak zaman uyumlu olarak döndürerek Task çağıran iş parçacığını engeller.

Aşırı Yüklemeler

Name	Description
ExecuteScalarAsync()	komutunu yürüten ve döndürülen ilk sonuç kümesindeki ilk satırın ilk sütununu döndüren zaman uyumsuz sürümü ExecuteScalar(). Diğer tüm sütunlar, satırlar ve sonuç kümeleri yoksayılır. ExecuteScalarAsync(CancellationToken) CancellationToken.None ile çağırır.
ExecuteScalarAsync(CancellationToken)	Bu, zaman uyumsuz sürümüdür ExecuteScalar(). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır. İptal belirteci isteğe bağlı olarak yoksayılabilir. Varsayılan uygulama zaman uyumlu ExecuteScalar() yöntemini çağırır ve tamamlanan bir görev döndürerek çağıran iş parçacığını engeller. Varsayılan uygulama, zaten iptal edilmiş bir iptal belirteci geçirilirse iptal edilmiş bir görev döndürür. ExecuteScalar tarafından oluşan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir. Döndürülen Görev tamamlanana kadar nesnenin DbCommand diğer yöntemlerini ve özelliklerini çağırmayın.

Açıklamalar

Zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Zaman Uyumsuz Programlama.

ExecuteScalarAsync()

Kaynak:

DbCommand.cs

komutunu yürüten ve döndürülen ilk sonuç kümesindeki ilk satırın ilk sütununu döndüren zaman uyumsuz sürümü ExecuteScalar(). Diğer tüm sütunlar, satırlar ve sonuç kümeleri yoksayılır.

ExecuteScalarAsync(CancellationToken) CancellationToken.None ile çağırır.

public:
 System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync();

public System.Threading.Tasks.Task<object?> ExecuteScalarAsync();

member this.ExecuteScalarAsync : unit -> System.Threading.Tasks.Task<obj>

Public Function ExecuteScalarAsync () As Task(Of Object)

Döndürülenler

Task<Object>

Zaman uyumsuz işlemi temsil eden bir görev.

Özel durumlar

DbException

Komut yürütülürken bir hata oluştu.

Açıklamalar

Zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Zaman Uyumsuz Programlama.

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.

Ayrıca bkz.

• ADO.NET’e Genel Bakış

ExecuteScalarAsync(CancellationToken)

Kaynak:

DbCommand.cs

Bu, zaman uyumsuz sürümüdür ExecuteScalar(). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır. İptal belirteci isteğe bağlı olarak yoksayılabilir.

Varsayılan uygulama zaman uyumlu ExecuteScalar() yöntemini çağırır ve tamamlanan bir görev döndürerek çağıran iş parçacığını engeller. Varsayılan uygulama, zaten iptal edilmiş bir iptal belirteci geçirilirse iptal edilmiş bir görev döndürür. ExecuteScalar tarafından oluşan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir.

Döndürülen Görev tamamlanana kadar nesnenin DbCommand diğer yöntemlerini ve özelliklerini çağırmayın.

public:
 virtual System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync(System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task<object?> ExecuteScalarAsync(System.Threading.CancellationToken cancellationToken);

abstract member ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>
override this.ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>

Public Overridable Function ExecuteScalarAsync (cancellationToken As CancellationToken) As Task(Of Object)

Parametreler

cancellationToken

CancellationToken

Zaman uyumsuz işlemi iptal etmek için bir belirteç.

Döndürülenler

Task<Object>

Zaman uyumsuz işlemi temsil eden bir görev.

Özel durumlar

DbException

Komut yürütülürken bir hata oluştu.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Zaman Uyumsuz Programlama.

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.

Ayrıca bkz.

• ADO.NET’e Genel Bakış