EntityFrameworkQueryableExtensions.SingleOrDefaultAsync Metode

Definisi

Ruang nama:

Microsoft.EntityFrameworkCore

Rakitan:

Microsoft.EntityFrameworkCore.dll

Paket:

Microsoft.EntityFrameworkCore v8.0.0

Overload

SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)	Secara asinkron mengembalikan satu-satunya elemen urutan, atau nilai default jika urutannya kosong; metode ini memberikan pengecualian jika ada lebih dari satu elemen dalam urutan.
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	Secara asinkron mengembalikan satu-satunya elemen dari urutan yang memenuhi kondisi tertentu atau nilai default jika tidak ada elemen tersebut; metode ini memberikan pengecualian jika lebih dari satu elemen memenuhi kondisi.

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

Secara asinkron mengembalikan satu-satunya elemen urutan, atau nilai default jika urutannya kosong; metode ini memberikan pengecualian jika ada lebih dari satu elemen dalam urutan.

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)

Jenis parameter

TSource

Jenis elemen source.

Parameter

source

IQueryable<TSource>

IQueryable<T> untuk mengembalikan elemen tunggal.

cancellationToken

CancellationToken

A CancellationToken untuk mengamati sambil menunggu tugas selesai.

Mengembalikan

Task<TSource>

Tugas yang mewakili operasi asinkron. Hasil tugas berisi elemen tunggal dari urutan input, atau default ( TSource) jika urutannya tidak berisi elemen.

Pengecualian

ArgumentNullException

sourceadalah null.

InvalidOperationException

source berisi lebih dari satu elemen.

OperationCanceledException

CancellationToken Jika dibatalkan.

Keterangan

Beberapa operasi aktif pada instans konteks yang sama tidak didukung. Gunakan await untuk memastikan bahwa setiap operasi asinkron telah selesai sebelum memanggil metode lain pada konteks ini. Lihat Menghindari masalah utas DbContext untuk informasi dan contoh selengkapnya.

Lihat Mengkueri data dengan EF Core untuk informasi dan contoh selengkapnya.

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

Secara asinkron mengembalikan satu-satunya elemen dari urutan yang memenuhi kondisi tertentu atau nilai default jika tidak ada elemen tersebut; metode ini memberikan pengecualian jika lebih dari satu elemen memenuhi kondisi.

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)

Jenis parameter

TSource

Jenis elemen source.

Parameter

source

IQueryable<TSource>

IQueryable<T> untuk mengembalikan elemen tunggal.

predicate

Expression<Func<TSource,Boolean>>

Fungsi untuk menguji elemen untuk kondisi.

cancellationToken

CancellationToken

A CancellationToken untuk mengamati sambil menunggu tugas selesai.

Mengembalikan

Task<TSource>

Tugas yang mewakili operasi asinkron. Hasil tugas berisi elemen tunggal dari urutan input yang memenuhi kondisi dalam predicate, atau default ( TSource ) jika tidak ada elemen tersebut yang ditemukan.

Pengecualian

ArgumentNullException

source atau predicate adalah null.

InvalidOperationException

Lebih dari satu elemen memenuhi kondisi di predicate.

OperationCanceledException

CancellationToken Jika dibatalkan.

Keterangan

Beberapa operasi aktif pada instans konteks yang sama tidak didukung. Gunakan await untuk memastikan bahwa setiap operasi asinkron telah selesai sebelum memanggil metode lain pada konteks ini. Lihat Menghindari masalah utas DbContext untuk informasi dan contoh selengkapnya.

Lihat Mengkueri data dengan EF Core untuk informasi dan contoh selengkapnya.