DbCommand.ExecuteScalarAsync Yöntem

Tanım

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
Kaynak:
DbCommand.cs
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 ();
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

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

Özel durumlar

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.

Şunlara uygulanır

ExecuteScalarAsync(CancellationToken)

Kaynak:
DbCommand.cs
Kaynak:
DbCommand.cs
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);
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

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

Özel durumlar

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

İ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.

Şunlara uygulanır