EntityFrameworkQueryableExtensions.SingleAsync Metode

Definisi

Ruang nama:

Microsoft.EntityFrameworkCore

Rakitan:

Microsoft.EntityFrameworkCore.dll

Paket:

Microsoft.EntityFrameworkCore v8.0.0

Overload

SingleAsync<TSource>(IQueryable<TSource>, CancellationToken)	Secara asinkron mengembalikan satu-satunya elemen urutan, dan melemparkan pengecualian jika tidak ada tepat satu elemen dalam urutan.
SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	Secara asinkron mengembalikan satu-satunya elemen urutan yang memenuhi kondisi tertentu, dan melemparkan pengecualian jika ada lebih dari satu elemen tersebut.

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

Secara asinkron mengembalikan satu-satunya elemen urutan, dan melemparkan pengecualian jika tidak ada tepat satu elemen dalam urutan.

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

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

<Extension()>
Public Function SingleAsync(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>

Untuk IQueryable<T> 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.

Pengecualian

ArgumentNullException

sourceadalah null.

InvalidOperationException

source berisi lebih dari satu elemen.

-atau-

source tidak berisi 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.

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

Secara asinkron mengembalikan satu-satunya elemen urutan yang memenuhi kondisi tertentu, dan melemparkan pengecualian jika ada lebih dari satu elemen tersebut.

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

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

<Extension()>
Public Function SingleAsync(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>

Untuk IQueryable<T> mengembalikan elemen tunggal.

predicate

Expression<Func<TSource,Boolean>>

Fungsi untuk menguji elemen untuk suatu 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 di predicate.

Pengecualian

ArgumentNullException

source atau predicate adalah null.

InvalidOperationException

Tidak ada elemen yang memenuhi kondisi dalam predicate.

-atau-

Lebih dari satu elemen memenuhi kondisi di predicate.

-atau-

source tidak berisi 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.