DbCommand.ExecuteScalarAsync Yöntem

Tanım

Ad Alanı:

System.Data.Common

Bütünleştirilmiş Kod:

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

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öntemi çağırır ve çağrılan iş parçacığını engelleyen tamamlanmış bir görev döndürür. Varsayılan uygulama, zaten iptal edilmiş bir iptal belirtecinden geçildiyse iptal edilmiş bir görev döndürür. ExecuteScalar tarafından oluşturulan ö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, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan ExecuteScalar()ö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öntemi çağırır ve çağrılan iş parçacığını engelleyen tamamlanmış bir görev döndürür. Varsayılan uygulama, zaten iptal edilmiş bir iptal belirtecinden geçildiyse iptal edilmiş bir görev döndürür. ExecuteScalar tarafından oluşturulan ö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, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan ExecuteScalar()özel durumlara bakın.

Ayrıca bkz.

• ADO.NET’e Genel Bakış