EntityFrameworkQueryableExtensions.SingleOrDefaultAsync Yöntem

Tanım

Ad Alanı:

Microsoft.EntityFrameworkCore

Bütünleştirilmiş Kod:

Microsoft.EntityFrameworkCore.dll

Paket:

Microsoft.EntityFrameworkCore v8.0.0

Aşırı Yüklemeler

SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)	Bir sıranın tek öğesini veya dizi boşsa varsayılan değeri zaman uyumsuz olarak döndürür; Bu yöntem, dizide birden fazla öğe varsa bir özel durum oluşturur.
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	Belirli bir koşulu karşılayan bir dizideki tek öğeyi veya böyle bir öğe yoksa varsayılan değeri zaman uyumsuz olarak döndürür; Bu yöntem, koşulu birden fazla öğe karşılarsa bir özel durum oluşturur.

SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)

Bir sıranın tek öğesini veya dizi boşsa varsayılan değeri zaman uyumsuz olarak döndürür; Bu yöntem, dizide birden fazla öğe varsa bir özel durum oluşturur.

public static System.Threading.Tasks.Task<TSource?> SingleOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken = default);

static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>

<Extension()>
Public Function SingleOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource), Optional cancellationToken As CancellationToken = Nothing) As Task(Of TSource)

Tür Parametreleri

TSource

öğelerinin sourcetürü.

Parametreler

source

IQueryable<TSource>

öğesinin IQueryable<T> tek öğesini döndürmek için.

cancellationToken

CancellationToken

CancellationToken Görevin tamamlanmasını beklerken gözlemlemek için bir.

Döndürülenler

Task<TSource>

Zaman uyumsuz işlemi temsil eden görev. Görev sonucu giriş dizisinin tek öğesini veya default dizi öğe içermiyorsa ( TSource) öğesini içerir.

Özel durumlar

ArgumentNullException

source, null değeridir.

InvalidOperationException

source birden fazla öğe içerir.

OperationCanceledException

CancellationToken İptal edilirse.

Açıklamalar

Aynı bağlam örneğinde birden çok etkin işlem desteklenmez. Bu bağlamda başka bir yöntemi çağırmadan önce zaman uyumsuz işlemlerin tamamlandığından emin olmak için kullanın await . Daha fazla bilgi ve örnek için bkz. DbContext iş parçacığı oluşturma sorunlarını önleme .

Daha fazla bilgi ve örnekler için bkz. EF Core ile veri sorgulama .

SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Belirli bir koşulu karşılayan bir dizideki tek öğeyi veya böyle bir öğe yoksa varsayılan değeri zaman uyumsuz olarak döndürür; Bu yöntem, koşulu birden fazla öğe karşılarsa bir özel durum oluşturur.

public static System.Threading.Tasks.Task<TSource?> SingleOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate, System.Threading.CancellationToken cancellationToken = default);

static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>

<Extension()>
Public Function SingleOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean)), Optional cancellationToken As CancellationToken = Nothing) As Task(Of TSource)

Tür Parametreleri

TSource

öğelerinin sourcetürü.

Parametreler

source

IQueryable<TSource>

öğesinin IQueryable<T> tek öğesini döndürmek için.

predicate

Expression<Func<TSource,Boolean>>

Bir koşul için bir öğeyi test etmek için bir işlev.

cancellationToken

CancellationToken

CancellationToken Görevin tamamlanmasını beklerken gözlemlemek için bir.

Döndürülenler

Task<TSource>

Zaman uyumsuz işlemi temsil eden görev. Görev sonucu, giriş dizisinin , veya default ( TSource ) içindeki predicatekoşulu karşılayan tek bir öğesini içerir; böyle bir öğe bulunmazsa.

Özel durumlar

ArgumentNullException

source veya predicate şeklindedir null.

InvalidOperationException

birden fazla öğe içindeki predicatekoşulu karşılar.

OperationCanceledException

CancellationToken İptal edilirse.

Açıklamalar

Aynı bağlam örneğinde birden çok etkin işlem desteklenmez. Bu bağlamda başka bir yöntemi çağırmadan önce zaman uyumsuz işlemlerin tamamlandığından emin olmak için kullanın await . Daha fazla bilgi ve örnek için bkz. DbContext iş parçacığı oluşturma sorunlarını önleme .

Daha fazla bilgi ve örnekler için bkz. EF Core ile veri sorgulama .