語言

EntityFrameworkQueryableExtensions.SingleOrDefaultAsync 方法

定義

多載

名稱 Description
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)

非同步回傳序列中唯一的元素,若序列為空則回傳預設值;此方法若序列中有多個元素,會拋出例外。

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

非同步回傳序列中唯一符合指定條件的元素,若不存在該元素則回傳預設值;此方法若有多個元素符合條件,則拋出例外。

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

來源:
EntityFrameworkQueryableExtensions.cs
來源:
EntityFrameworkQueryableExtensions.cs
來源:
EntityFrameworkQueryableExtensions.cs
來源:
EntityFrameworkQueryableExtensions.cs
來源:
EntityFrameworkQueryableExtensions.cs
來源:
EntityFrameworkQueryableExtensions.cs
來源:
EntityFrameworkQueryableExtensions.cs
來源:
EntityFrameworkQueryableExtensions.cs
來源:
EntityFrameworkQueryableExtensions.cs
來源:
EntityFrameworkQueryableExtensions.cs
來源:
EntityFrameworkQueryableExtensions.cs

非同步回傳序列中唯一的元素,若序列為空則回傳預設值;此方法若序列中有多個元素,會拋出例外。

public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken = default);
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)

類型參數

TSource

元素 source的類型。

參數

source
IQueryable<TSource>

一個 IQueryable<T> 回歸單一元素。

cancellationToken
CancellationToken

A CancellationToken 在等待任務完成時觀察。

傳回

Task<TSource>

一個代表非同步操作的任務。 任務結果包含輸入序列的單一元素,若defaultTSource序列中沒有元素,則包含( )。

例外狀況

source 是 null。

source 包含多個元素。

備註

不支援在同一上下文實例上進行多個主動操作。 在此上下文中,請用 await 以確認所有非同步操作已完成,然後再呼叫其他方法。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。

更多資訊與範例請參閱使用 EF Core 查詢資料 。

適用於

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

來源:
EntityFrameworkQueryableExtensions.cs
來源:
EntityFrameworkQueryableExtensions.cs
來源:
EntityFrameworkQueryableExtensions.cs
來源:
EntityFrameworkQueryableExtensions.cs
來源:
EntityFrameworkQueryableExtensions.cs
來源:
EntityFrameworkQueryableExtensions.cs
來源:
EntityFrameworkQueryableExtensions.cs
來源:
EntityFrameworkQueryableExtensions.cs
來源:
EntityFrameworkQueryableExtensions.cs
來源:
EntityFrameworkQueryableExtensions.cs
來源:
EntityFrameworkQueryableExtensions.cs

非同步回傳序列中唯一符合指定條件的元素,若不存在該元素則回傳預設值;此方法若有多個元素符合條件,則拋出例外。

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);
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)

類型參數

TSource

元素 source的類型。

參數

source
IQueryable<TSource>

一個 IQueryable<T> 回歸單一元素。

predicate
Expression<Func<TSource,Boolean>>

一個用來測試元素條件的函式。

cancellationToken
CancellationToken

A CancellationToken 在等待任務完成時觀察。

傳回

Task<TSource>

一個代表非同步操作的任務。 任務結果包含輸入序列中滿足條件 predicate的唯一元素,若 default 未找到該元素則為( TSource )。

例外狀況

source 或 predicate 為 null。

多個元素滿足該 predicate條件。

備註

不支援在同一上下文實例上進行多個主動操作。 在此上下文中,請用 await 以確認所有非同步操作已完成,然後再呼叫其他方法。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。

更多資訊與範例請參閱使用 EF Core 查詢資料 。

適用於