QueryableExtensions.SingleOrDefaultAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
非同步回傳序列中唯一符合指定條件的元素,若不存在該元素則回傳預設值;此方法若有多個元素符合條件,則拋出例外。 |
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken) |
非同步回傳序列中唯一的元素,若序列為空則回傳預設值;此方法若序列中有多個元素,會拋出例外。 |
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>) |
非同步回傳序列中唯一的元素,若序列為空則回傳預設值;此方法若序列中有多個元素,會拋出例外。 |
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) |
非同步回傳序列中唯一符合指定條件的元素,若不存在該元素則回傳預設值;此方法若有多個元素符合條件,則拋出例外。 |
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)
非同步回傳序列中唯一符合指定條件的元素,若不存在該元素則回傳預設值;此方法若有多個元素符合條件,則拋出例外。
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1011:ConsiderPassingBaseTypesAsParameters")]
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
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);
static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>
類型參數
- TSource
元素 source的類型。
參數
- source
- IQueryable<TSource>
一個 IQueryable<T> 回歸單一元素。
- predicate
- Expression<Func<TSource,Boolean>>
一個用來測試元素條件的函式。
- cancellationToken
- CancellationToken
A CancellationToken 在等待任務完成時觀察。
傳回
一個代表非同步操作的任務。
任務結果包含輸入序列中滿足條件 predicate的唯一元素,若 default 未找到該元素則為( TSource )。
- 屬性
例外狀況
source 或
predicate 是
null .
source 不實作 IDbAsyncQueryProvider 。
備註
不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前,請使用「wait」以確保所有非同步操作已完成。
適用於
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)
非同步回傳序列中唯一的元素,若序列為空則回傳預設值;此方法若序列中有多個元素,會拋出例外。
public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken);
static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>
類型參數
- TSource
元素 source的類型。
參數
- source
- IQueryable<TSource>
一個 IQueryable<T> 回歸單一元素。
- cancellationToken
- CancellationToken
A CancellationToken 在等待任務完成時觀察。
傳回
一個代表非同步操作的任務。
任務結果包含輸入序列的單一元素,若 default 序列中沒有元素,則為 (TSource)。
例外狀況
source 是
null .
source 有多個元素。
備註
不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前,請使用「wait」以確保所有非同步操作已完成。
適用於
SingleOrDefaultAsync<TSource>(IQueryable<TSource>)
非同步回傳序列中唯一的元素,若序列為空則回傳預設值;此方法若序列中有多個元素,會拋出例外。
public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource>(this System.Linq.IQueryable<TSource> source);
static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> -> System.Threading.Tasks.Task<'Source>
<Extension()>
Public Function SingleOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource)) As Task(Of TSource)
類型參數
- TSource
元素 source的類型。
參數
- source
- IQueryable<TSource>
一個 IQueryable<T> 回歸單一元素。
傳回
一個代表非同步操作的任務。
任務結果包含輸入序列的單一元素,若 default 序列中沒有元素,則為 (TSource)。
例外狀況
source 是
null .
source 有多個元素。
備註
不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前,請使用「wait」以確保所有非同步操作已完成。
適用於
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)
非同步回傳序列中唯一符合指定條件的元素,若不存在該元素則回傳預設值;此方法若有多個元素符合條件,則拋出例外。
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate);
static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> -> System.Threading.Tasks.Task<'Source>
<Extension()>
Public Function SingleOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean))) As Task(Of TSource)
類型參數
- TSource
元素 source的類型。
參數
- source
- IQueryable<TSource>
一個 IQueryable<T> 回歸單一元素。
- predicate
- Expression<Func<TSource,Boolean>>
一個用來測試元素條件的函式。
傳回
一個代表非同步操作的任務。
任務結果包含輸入序列中滿足條件 predicate的唯一元素,若 default 未找到該元素則為( TSource )。
- 屬性
例外狀況
source 或
predicate 是
null .
source 不實作 IDbAsyncQueryProvider 。
備註
不支援在同一上下文實例上進行多個主動操作。 在此上下文中呼叫其他方法前,請使用「wait」以確保所有非同步操作已完成。